Linking a Confluence page to an epic

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Are you on the right help page?

Using the classic Scrum and Kanban projects? You're in the right place!

Using an Agility project/featured project as part of the new Jira Software? Check out these pages instead.

If you're unsure, check your project menu. If it has the Give feedback and Learn more menu items, you're on an Agility project (aka featured project) and this page isn't for you.




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.

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 the Jira icon (, or ) > 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 the Jira icon (, or ) > 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 Aug 20, 2018

Was this helpful?

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