Skip to content
Start
Work // Tracker

Sub-issues and relations

Big pieces of work are easier to share out and track when they’re split up. A sub-issue is a full issue with its own status, assignee and comments that belongs to a parent issue. Relations link issues that aren’t parent and child: one can block another, or two can simply be related.

Adding two sub-issues to the home screen widget issue.

Add a sub-issue

Section titled “Add a sub-issue”

  1. Open the parent issue and click + (Add sub-issue) next to Sub-issues (1).

  2. Choose Create new sub-issue (2). To make an issue you already have a sub-issue, choose Link existing as sub-issue… and search for it.

  3. In the New issue dialog, the parent is already set. Type a title, set what you need and click Create issue.

The Sub-issues section of issue LUM-7 with three sub-issues and the Add sub-issue button marked
The Add sub-issue menu with Create new sub-issue and Link existing as sub-issue

You can also right-click an issue in a list and choose Add sub-issue….

The sub-issues show as a list on the parent’s page, with the same inline pickers as any list. Use the two buttons beside the heading to group, order and choose columns for this list, and Open sub-issues to see them as a full list of their own.

In lists, a parent shows a progress chip such as 0/3: how many of its sub-issues are done. Hover over or click it to see them by status. Sub-issues show their parent’s title after their own.

Give an issue a parent

Section titled “Give an issue a parent”

  1. Open the issue and click Add parent issue above its title (1).

  2. Choose Create new parent issue to make a new issue above this one, or Link existing as parent issue… to pick one. Only issues of the same project are offered.

The Add parent issue menu with Create new parent issue and Link existing as parent issue

Once an issue has a parent, a card with the parent’s ID and title sits above the title.

The parent card of LUM-8 showing its parent LUM-7, the sibling count and the Unset parent issue button
  1. Click the parent to open it.
  2. Click the number to see the parent’s other sub-issues.
  3. Click Unset parent issue to make the issue stand on its own again.
Section titled “Link related and blocking issues”

  1. Open the issue and click Add relation on the right (1). It’s also in the issue’s … menu.

  2. Choose the kind of relation (2): Blocked by, Blocks or Related.

  3. Search for the other issue (3) and click it. The relation is added at once.

The properties of LUM-16 showing Blocked by LUM-14, with Add relation marked
The Add relation dialog with the relation kind set to Related and the issue search marked

Linked issues appear as chips in Blocked by, Blocks and Related rows on both issues; click × on a chip to remove the relation. In a list, right-click an issue and open Relations for Mark as blocked by…, Mark as blocking… and Reference another issue….

To create a new issue that is related to the current one, choose New related issue in the issue’s menu. The New issue dialog opens with a related to chip.