Parent and Sub-Issues
Use sub-issues to break down larger "parent" tasks into smaller pieces of work.
Sub-issues are a good option when a set of work is too large to be its own issue but too small to be a project. It's also ideal for splitting up work shared across teammates, since we limit issues to one assignee.
We treat sub-issues and their parent issues as as separate entities. A sub-issue is related to it's parent hierarchy but they do not share properties and do not sum up or aggregate properties. A sub-issue has it's own own estimate count, assignee, labels, team, etc that is unrelated to the parent issue and vice versa.
If you use parent issues to summarize work but not represent tasks, you can configure estimates in team settings to allow for zero estimates, then assign a zero point value to parent issues.
Cmd/Ctrl Shift O to create sub-issue and Esc to exit sub-issue editor
Cmd/Ctrl Shift Pto add a parent
Cmd/CtrlShift Down to create sub-issue
Set parent issue via the command line
Create sub-issues directly by opening the parent issue and then clicking the
+ Add sub-issues button below the issue description. This will launch the launch the sub-issue editor. You can also use the shortcut Command Shift O to open the editor.
When you save a sub-issue, it will automatically launch the editor to create a new one. Press Esc to exist the sub-issue editor and continue updating the parent issue.
Sub-issues created in the editor automatically copy issue properties from the parent issue such as the project and cycle as long as those are set before you create the sub-issue.
Team, labels and assignees are not copied over. You can't create sub-issues while editing the parent issue but the option will come up once you press save.
Turn into sub-issue
Turn an existing issue(s) into sub-issues of another issue by selecting one or multiple issues and then taking the action to set the parent issue, accessible from the command menu and if you right-click over the issues.
To make an existing issue a parent issue of another issue, hover over a sub-issue and take the action Set Parent in the contextual menu, command menu or
Update a sub-issue to edit it just like you would any other issue. You can make changes to the sub-issue from a list or board view or open it to edit.
To make changes to a sub-issue while viewing the parent issue, hover over the issue in the sub-issue list and then use a keyboard shortcut or right-click to open a contextual menu to update any issue field. Some issue fields will show up by default on the issue, such as assignee and team, and you can click to update those.
We do not yet support multi-selecting sub-issues to update them from the parent issue so you'll have to make changes individually or multi-select manually from a board or list view.
You can usually set the view to show or hide sub-issues in View Options. You can also use Filters to show only top-level (parent) issues, issues with sub-issues, or only sub-issues. If you use these filters frequently, consider creating a custom view.
Navigate between issues
When you view a sub-issue, we'll show a header at the top that lets you click to navigate to the parent issue or any of the other sub-issues.