{"meta":{"title":"Browsing sub-issues","intro":"Learn how to navigate issue hierarchy in your repositories.","product":"GitHub Issues","breadcrumbs":[{"href":"/en/issues","title":"GitHub Issues"},{"href":"/en/issues/tracking-your-work-with-issues","title":"Issues"},{"href":"/en/issues/tracking-your-work-with-issues/using-issues","title":"Using issues"},{"href":"/en/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues","title":"Browsing sub-issues"}],"documentType":"article"},"body":"# Browsing sub-issues\n\nLearn how to navigate issue hierarchy in your repositories.\n\nYou can add sub-issues to an issue to quickly break down larger pieces of work into smaller issues. 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.\n\n## Navigating issue hierarchy\n\nYou can browse through all levels of sub-issues from the parent issue.\n\n1. Navigate to the parent issue.\n2. To view the sub-issues under another sub-issue, click the expand toggle (<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-triangle-right\" aria-label=\"triangle-right\" role=\"img\"><path d=\"m6.427 4.427 3.396 3.396a.25.25 0 0 1 0 .354l-3.396 3.396A.25.25 0 0 1 6 11.396V4.604a.25.25 0 0 1 .427-.177Z\"></path></svg>).\n\n   ![Screenshot of a sub-issues section. The expand toggle is highlighted with an orange rectangle.](/assets/images/help/issues/sub-issue-expand.png)\n\n## Finding a sub-issue's parent issue\n\nWhen you view a sub-issue, you can always find a link back to the parent issue in the header below the issue title.\n\n![Screenshot of a sub-issue's header. The link to the parent issue, \"Parent: create a scoreboard\", is highlighted with an orange rectangle.](/assets/images/help/issues/sub-issue-parent.png)\n\n## Using sub-issues in your projects\n\nYou 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](/en/issues/planning-and-tracking-with-projects/understanding-fields/about-parent-issue-and-sub-issue-progress-fields).\n\n## Browsing issue hierarchy with GitHub CLI\n\nGitHub CLI is an open source tool for using GitHub from your computer's command line. When you're working from the command line, you can use the GitHub CLI to save time and avoid switching context. To learn more about GitHub CLI, see [About GitHub CLI](/en/github-cli/github-cli/about-github-cli).\n\nTo view a parent issue along with its sub-issues, use the `gh issue view` subcommand.\n\n```shell\ngh issue view ISSUE-NUMBER\n```\n\nThe output includes the parent reference (if any) and a \"Sub-issues\" section that lists each sub-issue with its state and completion progress.\n\n```text\nBuild a scoreboard octo-org/octo-repo#123\nFeature · Open • monalisa opened 3 days ago • 2 comments\nAssignees: monalisa\nLabels: enhancement\nType: Feature\n\n  Track player scores across rounds.\n\nSub-issues · 1/3 (33%)\nClosed octo-org/octo-repo#124 Design scoreboard layout\nOpen octo-org/octo-repo#125 Persist scores between sessions\nOpen octo-org/octo-repo#126 Add a leaderboard view\n\nView this issue on GitHub: https://github.com/octo-org/octo-repo/issues/123\n```\n\nTo get the same information in a machine-readable form, use the `--json` flag with the `parent`, `subIssues`, and `subIssuesSummary` fields.\n\n```shell\ngh issue view ISSUE-NUMBER --json parent,subIssues,subIssuesSummary\n```"}