Create program dependencies



The old navigation will be removed from Jira Align in early 2024.
Learn more about the upcoming changes

Program dependencies are used to create dependencies between two programs on an epic or a capability as well as to create dependencies between program teams.

Create program dependencies on the dependencies page:

If you’re using the new navigation:

  1. Select Portfolios, Programs, or Teams in the top navigation bar and select the entity you want to create dependencies for.
  2. On the sidebar, select More items in the list of options.
  3. Select Dependencies; the dependencies page displays.

If you’re using the old navigation:

  1. Select Program from the left Nav menu.
  2. Under the Manage section, select Dependencies; the dependencies page displays.

To create a program dependency between programs:

  1. On the dependencies page, select the Add Dependency button on the toolbar (top-right of the page). The New Dependency slide-out panel displays.
  2. Select the PI from the Program Increment drop-down menu, select Epic or Capability as a work item type for this dependency, and then select the epic or capability itself.
  3. From the corresponding drop-down menus, select the Requesting program and the Depends On program.
  4. In the Needed By box, use the calendar to select the date this dependency needs to be resolved by.
  5. Click Save. The dependency is saved and additional fields display.

To create a program dependency between program teams:

  1. On the dependencies page, select the Add Dependency button on the toolbar (top-right of the page). The New Dependency slide-out panel displays.
  2. From the Program Increment drop-down menu, select the PI in which the dependency should be delivered.
  3. Select Feature as a work item type for your dependency and start typing text (name, ID, or tag) in the search box to search for the feature. Click the desired feature to select it.
  4. Next to the Requesting option, select Program, and then select the program team that requests the work.
  5. Next to the Depends On option, select Programs, and then select one or more program teams on which your work is dependent.
  6. In the Needed By box, use the calendar to select the date this dependency needs to be resolved by.
  7. Click Save. The dependency saves and additional fields display on the Dependency slide-out panel for tracking purposes. The dependency’s originator displays under the Requesting field for further reference.
    When a dependency is saved, the Depends On team is sent an email request to review the dependency. The roles selected under the Program Dependency email setting will receive this email. You can assign links to the dependency that provide more info. After saving, you can also assign stories to indicate the work needed to satisfy the dependency.

At this point, a negotiation takes place between the requester and the respondent. The respondent can access the dependency in the To Do section of the dependencies page and take appropriate action. They can choose to:

  • Reject the dependency and provide a reason for the rejection.
  • Commit to the Needed By date and accept the dependency.
  • Send a new proposed date back to the requester by which the team can deliver the dependency. This can take many iterations until both sides agree on the commit date.

Each party will see a slightly different interface when accessing the dependency in the dependency grid or the dependency panel, depending on the state of the dependency. For example, actions such as accept, reject, or unblock a dependency may be available during the negotiation to commit.


Either party may choose to block the dependency. 

The respondent can also indicate that no work is required for the dependency.


  • The Depends On team's program room is also updated to include the dependency. The dependencies are listed under Dependency Backlog. You can click the dependency to edit it.
  • If the requesting team selects multiple affected teams, for example, if an infrastructure change affects many teams participating in the PI, this will be a multiple team dependency.
Was this article helpful?
2 out of 2 found this helpful
Print Friendly Version of this pagePrint Get a PDF version of this webpagePDF

Join the Atlassian Community!

The Atlassian Community is a unique, highly collaborative space where customers and Atlassians come together. Ask questions and get answers, start discussions, and collaborate with thousands of other Jira Align customers. Visit the Jira Align Community Collection today.

Need to contact Jira Align Support? Please open a support request.