Link a Confluence page to an epic

If you have linked your Jira Software site to Confluence, you can create and link Confluence pages to your epics. For example, you may want to link your epic to a specification or design document in Confluence.

Here’s an example of a linked page in an epic:

Creating a new linked Confluence page for an epic

Note, these instructions apply to Scrum boards, as well as Kanban boards where both the Kanban backlog and Epics panel are enabled.

1. Log in to Jira and select Projects in the navigation bar.

2. Choose the relevant project and select Backlog.

3. Click EPICS (aligned vertically, left side of the board) to show the 'EPICS' panel.

4. Click Linked pages at the bottom of the epic details in the Epics panel.

5. Click Create page. The 'Create' dialog in Confluence will be displayed, with the Product Requirements blueprint selected (select a different blueprint, if you don't want to use it).

Note, you cannot create a new linked Confluence page when viewing an epic in Jira Software, although you can link an existing Confluence page (see instructions below).

Linking an existing Confluence page to an epic

In the Backlog:

1. Log in to Jira and select Projects in the navigation bar.

2. Choose the relevant project and select Backlog.

3. Click EPICS (aligned vertically, left side of the board) to show the 'EPICS' panel.

4. Click Linked pages at the bottom of the epic details in the Epics panel.

5. Click Link page, search for the page you want, and select it.

When viewing the epic in Jira Software (Scrum and Kanban boards):

1. View the issue or story in Jira. Note, you need to view the issue in its own browser tab, i.e. not in the issue detail view on the board.

2. Click More > Link. This displays the Link dialog.

3. Click the Confluence Page tab in the dialog, and enter the details for the page you want to link to.