Edit

Share via


Track dependencies in Delivery Plans

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Delivery Plans provide visual dependency tracking for work items linked with Predecessor/Successor relationships. Dependency visualization helps you identify scheduling conflicts and manage cross-team dependencies effectively.

Cards display dependency status icons:

  • Green icon: No dependency scheduling issues
  • Red icon: Dependency scheduling conflicts detected

Screenshot of delivery plan showing work items with dependencies and dependency issues.

Prerequisites

Requirement Description
Access Member of the Project Collection Valid Users group or Stakeholder access
Permissions Edit work items in this node permission set to Allow for relevant Area Paths
Configuration Delivery Plan created with teams and backlogs configured
Dependencies Work items linked using Predecessor-Successor link type

For complete setup requirements, see Add or edit a Delivery Plan.

Tip

You can create dependencies between work items across different projects and teams within the same organization. Dependencies across organizations aren't supported.

View dependency lines

  1. Open your Delivery Plan from Boards > Delivery Plans.

  2. Select the top or bottom edge of a work item card to show its dependency lines. Select again or select elsewhere to hide the lines.

    No scheduling conflicts (black lines): Screenshot of dependency lines showing no scheduling issues.

    Scheduling conflicts (red lines): Screenshot of dependency lines showing scheduling conflicts between work items.

    Tip

    Expand both team rows to see dependency lines across teams.

  3. To view conflict details, select the issue icon on the work item card.

    Screenshot showing dependency conflict details in a work item card.

View dependency details

For detailed dependency information, select the dependency icon ( or ) on any work item card.

Screenshot of work item card with dependency icon highlighted.

The Dependencies dialog shows:

  • All predecessor and successor work items
  • Dependency status and any scheduling conflicts
  • Cross-project dependencies (when applicable)

Screenshot of Dependencies dialog showing work items with no scheduling conflicts.

Resolve dependency conflicts

Dependency conflicts occur when a successor work item is scheduled to complete before its predecessor. These conflicts appear with red indicators in the Dependencies dialog.

Screenshot of Dependencies dialog showing scheduling conflicts with red indicators.

To resolve conflicts:

  • Review scheduling: Check the Target Date or Iteration Path end dates for conflicting work items
  • Adjust timing: Modify work item dates or iteration assignments to resolve scheduling conflicts
  • Re-evaluate dependencies: Consider if dependency relationships are still accurate

Note

Dependency end dates are determined by either the work item's Target Date or the End Date of its assigned Iteration Path.

Best practices for dependency tracking

  • Use consistent link types: Always use Predecessor-Successor links for dependency tracking
  • Regular review: Check dependency status during sprint planning and reviews
  • Cross-team coordination: Expand team rows to visualize dependencies across teams
  • Proactive management: Address red dependency indicators promptly to avoid delays