Skip to main content
Skip table of contents

Dependencies: visualizing links between items

When planning work across teams, it’s important to manage the dependencies between different pieces of work. This allows you to see and remove blockers so that your teams can execute smoothly.

Visualizing dependencies

In Easy Agile Programs, you can visualize links between Jira issues as dependency lines.

This means that an issue link like “is blocked by” will show as a line between the two issues in Easy Agile Programs.

Jira DC issue blocks and is blocked by.png

Issue links in the Jira Data Center issue view

Dependency lines on issue 710.png

Dependency lines on the Team planning page in Easy Agile Programs

How many dependency/link types will show?

Each Program is configured with 1 issue link type from Jira as the “default” dependency link type (see Configuring dependencies for a Program for details). This will be toggled on automatically for all users.

We’ve recently added the option to view additional issue link types as dependencies.

Open the “Dependencies” dropdown on any page to select link types from Jira. This will be saved only for you.

Dependency dropdown open, showing a section named type and one selected opens blocks slash is blocked by

Additional dependency link types are available:

  • On Jira Cloud (i.e. Jira sites with “….atlassian.net” in the URL) on all pages of the app

  • In Data Center version 7.3.0+

In older versions of the app, the “Type” section will be missing from the “Dependencies” dropdown. Only the 1 dependency link type configured for the Program will be shown.

On the Program board

Use the Program board page to see an overview of the dependencies across your Increment or Release Train.

Program board 710.png

Dependencies on the Program board page

Try the new Dependency map to focus on only the issues with dependencies!

On the Team planning page

On the Team planning page, you can track both in-team dependencies and dependencies with other teams.

Team planning dependency lines 710.png

Add another team from your Program using the “Other teams” button in the top right. If there are already dependencies with that team, you’ll see colored numbers describing the health of those dependencies.

Team planning add another team 710.png

Use this to visualize how your team’s work depends on or enables other teams.

By seeing the potential blockers and sequencing work as needed, you can enable smoother cross-team work towards your shared goals.

Team planning additional team 710.png
Team planning additional team 710.png

Dependency details

When you hover over a dependency line, you’ll see an (info) information icon. Click this to see the details of this dependency link.

Team planning issues dependency info icon.png
Dependency details.png

On earlier versions of Easy Agile Programs, there is a (error) cross icon when you hover on a dependency line (instead of an information icon). This will trigger a pop-up asking you if you want to delete this issue link from the Jira issues.

Understanding dependency status

Learn more about Understanding dependency status, health, and color.

Color-coded dependency lines

Dependency lines show in different colors depending on the health of the dependency. This quickly identifies if the work is scheduled in the correct order.

  • Red: Conflict

  • Orange: At risk

  • Green: Healthy

Team planning issues dependency info icon.png

External dependencies are links with work that’s not in this Program/Increment.

The health of these dependencies can’t be calculated, so is shown in black.

External dependency icon on issue 710.png

Learn more about dependency health and external dependencies.

Done dependencies

Easy Agile Programs filters out done dependencies so you can focus on the dependencies that need your attention.

Easy Agile Programs checks the Status Category of the two linked issues to calculate if a dependency is “Done”. If one or both of the issues are already in any “Done” Status, the dependency is counted as Done.

Learn more about Done dependencies.

Filtering dependencies

Dependency map

Try the new Dependency map to focus on only the issues with dependencies!

Show/hide dependency lines based on health

You can switch dependency lines on and off based on their health/color. For example, you might switch off green Healthy dependencies so that you can focus on resolving At-risk and Conflict plans.

Find these options in the “Dependencies” dropdown in the header on any page.

Team planning filter healthy dependencies 710.gif

In older versions of Easy Agile Programs on Data Center (v7.2.0 and earlier), dependency options are in the “View settings” dropdown only on the Program board page.

Program board view settings dropdown 710.png

Filtering issues by dependencies, Status or Team board

Open the Filters panel on the Program board to filter the page based on Dependency health, Status category, or Team/board.

For example, you might choose to show issues with At risk or Conflict dependencies so that you can assess these potential risks.

Program board filters at risk and conflict Filters button highlighted 710.png

Note: If two issues visible with these filters also have a dependency of a different color, that other link will show too.

Creating and editing dependencies

There are two ways to create dependencies between issues:

  1. Create a dependency between two team-level issues on the Team planning page.

  2. Add an issue link to an issue in Jira.

It’s currently only possible to create dependencies between two team-level issues within the app.

Creating dependencies between team-level issues in Easy Agile Programs

On the Team planning page, switch to “Create dependencies” mode using the button in the header. The button will be dark when this mode is enabled.

Create dependencies mode button.gif

In “Create dependencies” mode, click two issues to create a new dependency:

  1. The issue that requires something

  2. The issue that unblocks the first issue

In newer versions of the app, you’ll see help text on the line that says what link type and direction you’ll create.

Create dependencies in team.gif

Creating a new dependency linking 2 items on the Team planning page.

This issue link will be added to the issues in Jira.

Jira DC issue view showing is blocked by.png

The new issue link is visible on the Jira issue.

Add another team to view and manage dependencies across teams.

Use the “Other teams” button in the header to add another team to the page.

Team planning add another team 710.png

You can use “Create dependencies” mode to create cross-team dependencies as well.

Team planning create cross team dependency 710.png

Creating dependencies in Jira

Add an issue link in Jira to see that link on the issue in Easy Agile Programs. To do this, edit the issue in Jira.

Jira Cloud (has “….atlassian.net” in the URL)

Jira Data Center

In the “+ Add” dropdown, use the 🔗 “Link issue” option:

Jira Cloud issue view with Add dropdown open showing Linked issue option

Under the “More” menu, use the “Link” option.

Jira DC issue view More dropdown Link highlighted.png

See Atlassian’s guide for Jira Cloud.

See Atlassian’s guide for Jira Data Center.

The issue link type will need to match the Dependency link type configured for the Program.

If you have the latest version of the app, you’ll also see the issue link type named in the Dependencies map panel on the Program board page.

Dependency map link type highlighted 710.png

Deleting dependencies

When viewing the Dependency details modal, you’ll have the option to delete a dependency link. This will delete the issue link in Jira.

Dependency details delete highlighted.png

If you’ve made a mistake, watch for a flag in the bottom left of your screen with an “Undo” button.

Dependency deleted flag undo.png

You can also remove the issue link from the issue in Jira. The dependency line will be gone the next time you load or refresh the Easy Agile Programs app.

On earlier versions of Easy Agile Programs, there is a (error) cross icon when you hover on a dependency line (instead of an information icon). This will trigger a pop-up asking you if you want to delete this issue link from the Jira issues.

Troubleshooting dependencies

If dependency lines aren’t working as expected, reach out to the Easy Agile support team!

What permissions are required to create or edit dependencies?

To create new issue links, you’ll need the “Link Issues” permission. If the issues you want to link are from different Jira projects, you’ll need this permission for both projects.

If you don’t have permission to create issue links in Jira, you’ll see an error when trying to create dependencies in Easy Agile Programs.

A Jira Administrator can update these permissions by editing the Permissions Scheme for the project(s). See Atlassian’s guide for Jira Cloud or for Jira Data Center.

Some dependency lines are missing, even though they’re the correct issue link type

The “Linked issues” field might be hidden on the Issue Screen. This doesn’t stop the “Linked issues” section showing in the Jira issue view, but does prevent apps like Easy Agile Programs from loading issue link data.

Changing the dependency configuration

Users with Manage Programs permission can change the dependency link type for a Program. Learn more about configuring dependencies.


Other ways of visualising dependencies and blockers

Visualize Flags (impediments) from Jira in Easy Agile Programs.

See scheduling conflicts when the issues for an Epic are scheduled outside the dates for that Epic.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.