Parent and Sub-Issues

Use sub-issues to break down larger "parent" tasks into smaller pieces of work.

Overview

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/CtrlShift Down to create sub-issue

Set parent issue via the command line

Basics

Create sub-issues

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.

Copy properties

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 ∙∙∙ menu.

Update sub-issues

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.

Filter sub-issues

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.