Note
Issue types, sub-issues, and advanced issue search are currently in an opt-in beta for organizations. To learn more and add your organization to the waitlist, see the "GitHub Blog."
You can add sub-issues to an issue to quickly break down larger pieces of work into tasks. Sub-issues add support for hierarchies of issues on GitHub by creating relationships between your issues. You can create multiple levels of sub-issues that accurately represent your project by breaking down tasks into exactly the amount of detail that you and your team require.
Navigating issue hierarchy
You can browse through all levels of sub-issues from the parent issue.
-
Navigate to the parent issue.
-
To view the sub-issues under another sub-issue, click the expand toggle ().
Finding a sub-issue's parent issue
When you view a sub-issue, you can always find a link back to the parent issue in the header below the issue title.
Using sub-issues in your projects
You can add sub-issues to your projects and make use of the hierarchy data for building views, grouping items, and filtering your views. See "About parent issue and sub-issue progress fields."