Issue relations

Create blocking relationships between issues.

Overview

Tag issues with dependencies so your team can see what is stuck and what is in the way. You can mark issues as Blocked by another issue, or as Blocking other work. The two sides are mirrored — adding a blocker on one issue adds Blocking on the other.

Add relationships

The related issues show up in the issue properties sidebar under Blocked by and Blocking.

From an issue, open the overflow menu and choose Mark as, then Blocked by… or Blocking…. Search for the other issue and confirm. You can add as many of either kind as you like; repeat the steps for each one.

From a list or board, open the same overflow menu on a selected issue. You can also choose Create related → Blocked issue… to create a new issue that this one blocks.

To remove a relation, hover the row in the sidebar card and choose Remove relation, or open Remove in the overflow menu and pick the blocker or blocking issue.

Parent and sub-issues are a separate hierarchy — see Parent and sub-issues. Creating a sub-issue uses Cmd/Ctrl Shift O; marking an issue as a sub-issue uses Cmd/Ctrl Shift P.

Blocked / blocking

Mark an issue as blocked by another from Mark as → Blocked by…. Open blockers show a chip on the list or board. Once every blocker is Done, that chip is dropped; the relation stays on the detail sidebar so you can still open or remove it.

Mark an issue as blocking other work from Mark as → Blocking…. Issues it still blocks show a Blocking chip until this issue is Done.

Filter a view with F and Relations. Choose Has blockers, Has dependents, or No relations. Selecting several values reads as OR. The filter answers whether a relation exists; the row chip answers whether anything is still holding the work up.