Parent and sub-issues

Break a parent issue into sub-issues that inherit project, cycle, and milestone.

Use sub-issues to break a larger parent issue into smaller pieces of work.

Overview

Create sub-issues when a set of work is too large to be a single issue but too small to be a project. Each sub-issue is a full issue with its own title, status, and assignee. Adding a sub-issue makes the other issue its parent.

Create a sub-issue

Open the parent and click Add sub-issue (or Add sub-issues) below the writeup.

You can also press Cmd/Ctrl Shift O, or open the command menu and choose Create sub-issue…. Press Cmd/Ctrl Shift → to focus the sub-issues section.

The child uses the parent's team. Save it like any other issue.

Copy properties

Sub-issues inherit the parent's project, cycle, and milestone. You cannot set cycle directly on a sub-issue. They keep their own releases.

Converting issues

Turn issues into sub-issues

Turn an existing issue into a sub-issue by selecting it and choosing Set parent (Cmd/Ctrl Shift P), then picking the parent.

Turn sub-issues into issues

Clear Parent on the sub-issue to make it a top-level issue again. It stays in the same team.

Filter sub-issues

You can filter by Parent issue. Deleting a parent also deletes its sub-issues. See Delete issues.

Display options

In Display options (Shift V), toggle Show sub-issues and Nested sub-issues.

Last updated on