Issue relations

Create relationships between issues such as blocking, related, and duplicate.

Overview

Tag issues with relations and dependencies to help your team identify and remove blockers and work on the most important issues. You can mark issues as blocked, blocking, related, and duplicate.

Add relationships

The issue and type of relationship will show up in the issue properties sidebar.

From the issue editor, add a relation using keyboard shortcuts or by selecting the overflow menu after saving the issue. From a list or board, use either the keyboard shortcut, command menu or contextual menu. You'll be prompted to find and select the related issue. You can add as many related, blocking, blocked, or duplicate flags as you like but will have to repeat the steps for each one.

Related issue

When you reference issues in a description or comment, they'll automatically become a related issue. Alternatively, use M + R to relate one issue to another. When viewing an issue you can open the command menu (⌘/CTRLK) and type "Create new issue related to…".

To remove a related issue, hover over the related issue and click the X. You can also select Remove relation from the command menu ⌘/Ctrl K. If you have more than one relation, you'll be prompted to select which relation to remove.

Blocked / blocking

Mark issues as blocked by other issues with M then B. If other issues are blocking the current issue, they'll show up in the issue sidebar with an orange flag under Blocked by.

Mark issues as blocking other issues with M then X. If the issue is blocking other work, the blocked issues show up in the issue sidebar with a red flag under Blocks.

Once the blocking issue has been resolved, the blocked issue flag turns green and moves under Related.

Duplicate

Merge duplicate issues into the canonical (saved) issue with the shortcut by pressing M and M. This will mark the issue you are viewing or have selected as a duplicate issue and change the status to canceled. You cannot mark issues the other way around (e.g. view the canonical issue and mark other issues as duplicates of it). If you have more than one canceled status, you can specify which status to apply under Team Settings > Workflow.