Browsing sub-issues

Learn how to navigate issue hierarchy in your repositories.

In this article

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.

You can browse through all levels of sub-issues from the parent issue.

  1. Navigate to the parent issue.

  2. To view the sub-issues under another sub-issue, click the expand toggle ().

    Screenshot of a sub-issues section. The expand toggle is highlighted with an orange rectangle.

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.

Screenshot of a sub-issue's header. The link to the parent issue, "Parent: create a scoreboard", is highlighted with an orange rectangle.

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."