Link a Confluence page to an epic

Are you on the right help page?

The following information only applies to classic projects.

To check which project you need help with, look at the bottom of your project’s left-hand sidebar:

  • If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a next-gen project. Check out our next-gen project documentation.

  • If you don’t, you're in a classic project.

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 linked pages in an epic:

A scrum backlog. The epic Frontend is expanded in the left navigation. A Linked pages modal show 1 page linked to the 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.

 

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 Jul 7, 2020
Cached at 10:44 PM on Nov 25, 2020 |

Additional Help

Ask the Community