Linking a Confluence page to an epic

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

NOTE: Using Jira's new agility board? It's currently in beta development phase, which means you may not (yet) have access to the features described below. 

 

 If you have linked your Jira Software instance to a Confluence instance, 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.

On this page:

Screenshot: linked pages for an epic (Scrum board)

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.
  2. Click 

    Unable to render {include} The included page could not be found.
     > Projects, then 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.

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 Backlog:

  1. Log in to Jira.
  2. Click 
    Unable to render {include} The included page could not be found.
     > Projects, then 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.

Next steps

 Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

Last modified on Jan 29, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.