Adding sub-issues - GitHub Docs Skip to main content GitHub Docs Version: Free, Pro, & Team Search or ask Copilot Search or ask Copilot Select language: current language is English Search or ask Copilot Search or ask Copilot Open menu Collapse sidebar Expand sidebar Scroll breadcrumbs left * Home * GitHub Issues * Issues * Using issues * Adding sub-issues Scroll breadcrumbs right GitHub Issues * * * Issues * Learning about issues * About issues * Quickstart for GitHub Issues * Planning and tracking work for your team or project * Using issues * Create an issue * Adding sub-issues * Creating issue dependencies * Assign issues & PRs * Editing an issue * View all issues & PRs * Browsing sub-issues * Filter and search * Create branch for issue * Link PR to issue * About slash commands * Managing issue types * Managing issue fields * Using issue fields * Administering issues * Triage an issue * Pin an issue * Marking issues or pull requests as a duplicate * Transfer an issue * Close an issue * Deleting an issue * Clone an issue * Projects * Learning about Projects * About Projects * Quickstart for Projects * Best practices for Projects * Creating projects * Creating a project * Copying a project * Managing items in your project * Adding items * Converting draft issues * Editing items * Archiving items * Understanding fields * About text and number fields * About date fields * About single select fields * About iteration fields * About issue fields * About sub-issue fields * About pull request fields * About the issue type field * Renaming custom fields * Deleting custom fields * Customizing views * Changing the layout * Customizing tables * Customizing boards * Customizing roadmaps * Filtering projects * Managing your views * Automating projects * Using built-in automations * Automating with the API * Automating with Actions * Adding items automatically * Archiving items automatically * Viewing insights * About insights for Projects * Creating charts * Configuring charts * Managing your project * Managing project visibility * Managing project access * Managing templates * Closing and deleting projects * Adding a project to a repo * Adding a project to a team * Exporting your project data * Finding your projects * Sharing project updates * Labels and milestones * Managing labels * About milestones * Create & edit milestones * Add to milestones * Filter by milestone * View progress to milestone Adding sub-issues Learn about using sub-issues to break down your work into tasks. Who can use this feature? People with at least triage permissions for a repository can add sub-issues. Copy as Markdown In this article * Creating a sub-issue * Adding an existing issue as a sub-issue * Working with sub-issues using GitHub CLI You can add sub-issues to an issue to break down larger pieces of work into tasks. Your sub-issues show their relationship to the parent issue allowing you to track your work across GitHub. Parent issues and sub-issue progress is also available in your projects, allowing you to build views, filter, and group by parent issue. Your sub-issues can themselves contain sub-issues, allowing you to create full hierarchies of issues that visualize entire projects or pieces of work and show the relationships between your issues. You can add up to 100 sub-issues per parent issue and create up to eight levels of nested sub-issues. Creating a sub-issue * Navigate to the issue that you want to add a sub-issue to. * At the bottom of the issue description, click Create sub-issue . * In the dialog, type the title for your sub-issue. * Optionally, type the description for your issue, and set the issue type and any assignees, labels, projects, and milestones. * Optionally, if you want to continue create sub-issues for this parent issue, select Create more sub-issues . * Click Create . Adding an existing issue as a sub-issue * Navigate to the issue that you want to add a sub-issue to. * At the bottom of the issue description, next to "Create sub-issue", click . * In the drop-down menu, click Add existing issue . * Select the issue that you want to add as a sub-issue. * Select an issue from one of the suggestions. * In the "Search issues" field, type an issue title or issue number, then click on the results. * To add issues from other repositories, click next to the repository name and select a different repository. Working with sub-issues using GitHub CLI GitHub 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 . To create a new issue as a sub-issue of an existing parent, use the --parent flag with gh issue create . The parent can be specified by issue number or URL. gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER To add existing issues as sub-issues of a parent, use the --add-sub-issue flag with gh issue edit . The flag accepts a comma-separated list of issue numbers or URLs. gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER To remove a sub-issue from its parent, use --remove-sub-issue on the parent or --remove-parent on the sub-issue. gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER gh issue edit SUB-ISSUE-NUMBER --remove-parent Back to top Help and support Was this Doc helpful? Yes No Help us make GitHub Docs great! All Docs are open source. See something that's wrong or unclear? Submit a pull request. Make a contribution Still need help? Ask the GitHub community Contact support Expert services Blog GitHub Inc. © 2026 Terms Privacy Status Pricing