Manage dependencies on the roadmap

This page is for company-managed projects

If the lower-left of your project sidebar says you're in a team-managed project, check out these team-managed project articles instead.

Learn more about the difference between company-managed and team-managed projects.

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 issues to reveal dots on either side.

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

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

When using this method, your roadmap automatically configures the dependency (either blocks or is blocked by) based on the order of issues.

From the issue detail view:

  1. Select an issue on the roadmap.

  2. Select Link issue.

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

View details of linked dependencies

Select the dependency line or the link icon on an issue to get a detailed view of its dependencies. If your epics have child issues with dependencies, they’ll show in this window when the epic is collapsed on your roadmap.

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 roadmap displays the epic "Website rebuild" connected by a red line to the epic "Global rebrand". The dates overlap

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 Jul 12, 2021
Cached at 9:02 PM on Jul 31, 2021 |

Additional Help

Ask the Community