Manage dependencies between epics on the roadmap

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.

Your team might have one epic that's blocking the progress of another, or two epics that impact one another. The roadmap helps you visualize the dependencies between epics.

Issue linking is activated by default. If your issue linking is OFF, a Jira admin can enable it. Once it's active, you can link between issues to create dependencies.

The issue linking screen in board settings. A large, green ON indicates issue linking is currently on.

To capture dependencies, the roadmap relies on a specific issue link type called Blocks. The link type is required, however, it can be renamed to suit your team. If the link type is deleted, the roadmap will create another in its place.

There are two ways to visualize dependencies on your roadmap.

Directly on your roadmap:

  1. Hover over an epic to reveal dots on either side of an epic. 

  2. Drag one of the dots to the epic you want to link to. 

A mouse cursor hovers on an epic in the roadmap to display the start and end dates, and two dots.

From the epic issue detail view:

  1. Select an epic on the roadmap.

  2. Select Link issue.

  3. Select either blocks or is blocked by, then select the epic to link.

View details of linked dependencies

Select the dependency line or the link icon on an epic to get a detailed view of the linked epics.

Select a dependency line on your roadmap to see details about how each epic impacts one another.

If one of your epics is scheduled to start before a dependent epic is due to finish, the dependency link turns red. This signals the potential for delay or risk.

A cropped epic in a roadmap displays the epics "Website rebuild" connected by a red line (blocks) to "Global rebrand".

Remove dependencies

To remove a dependency between two epics, select Unlink issue or delete the issue link in the issue detail view.

Last modified on Nov 26, 2020
Cached at 8:56 PM on Mar 6, 2021 |

Additional Help

Ask the Community