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