Sub-issues Public Preview #139932
Replies: 99 comments 184 replies
-
Can sub-issues reference issues in other repos, or is it like sub-tasks (tracked issues feature) limited to issues in the same repo? Are sub-issues replacing tasks-lists? Update: We now have the beta enabled and I can confirm that sub-issues can be cross-repo. Actually, clarifying how sub-issues relate (or not) to task-lists would be useful. We have the beta enabled now and I think I'm noticing some changes (for the better) to how task-lists show up, e.g. the sub-tasks in the issue header seems to have gone, but the "tracked by" in the child task is still there. There's also overlap now between parent issues (which you can now group-by and slice-by in project views) and Milestones as a mechanism for grouping issues. The biggest differences being:
|
Beta Was this translation helpful? Give feedback.
-
The parent issue title is not parsed correctly in table view, as text wrapped in backticks (`) isn’t rendered as code: |
Beta Was this translation helpful? Give feedback.
-
One benefit of Tasklists was that you can track one issue in multiple "parent" issues, going back to only allow one parent issue is not great. Would love to see that an issue can have n parent issues. |
Beta Was this translation helpful? Give feedback.
-
I'm a little surprised that PRs can't be added as sub-issues. I mean I suppose it's in the name sub-issues, but especially when it comes to project views, it feels like it'd be very fitting for the PRs to be located alongside/as a sub of the issue they're closing. |
Beta Was this translation helpful? Give feedback.
-
It doesn't look like sub-issue creation allows for selecting an issue template/form. Is that something being considered? |
Beta Was this translation helpful? Give feedback.
-
I'd love to be able to see repo names in sub-issue lists. |
Beta Was this translation helpful? Give feedback.
-
I commonly create "roadmap" issues that contain a variety of "issues" which are really sub-issues. It is incredibly productive to use Proposal: provide a mechanism for me to rough out an issues list like so, and then create sub issues from them instead of issues.
|
Beta Was this translation helpful? Give feedback.
-
First of all, THANK YOU. SO awesome. One thing - I love that I can link existing issues to parents/children. That said, it would be awesome if, when I choose link existing, I could just paste in the link to the issue (either full GitHub url or org/repo#xx) and it surfaces that immediately (or just saves). Lots of times I have the link handy from another tab/location and this would make navigating that much easier. |
Beta Was this translation helpful? Give feedback.
-
I'd find it useful to be able to configure the filter for the default issue list and count. I'd like to be able to omit issues with a parent (sub-issues) from the default view. Using sub-issues as a way to build up the tasks for a larger feature is something useful, but it's very noisy to have a lot of sub-issues polluting the default view. At the same time, it's very useful to have them show up in search and have their own issues for implementation discussion. |
Beta Was this translation helpful? Give feedback.
-
When I am inside a parent issue, and I would like to add sub-issues, I have the option to click |
Beta Was this translation helpful? Give feedback.
-
I would really like to have this option enabled on the Project only issues. The use case is to have a cross repo issue as a parent which should not get converted to the repo issue. Now sub-isssues are only available in the repo issues |
Beta Was this translation helpful? Give feedback.
-
Please allow migration/conversion of Tasks lists to parent/sub-issues! It's quite tedious to manually move every single issue to have a parent relationship. |
Beta Was this translation helpful? Give feedback.
-
I like that I can group issues by parent issue on project boards; but is there a way to control which parent issues are allowed to be part of that top-level grouping? Working off of https://github.com/orgs/community/discussions/139932#discussioncomment-10817810 I am a big fan of the idea to use a top-level parent issue as a sort of cross repo milestone. Normally the way I lay out a project I have this sort of hierarchy:
Currently I use milestones as best I can to track a top-level status of projects across my team on a single project board. I was hoping to do the same thing with a top-level project type issue and be able to display a hierarchy of: project issue -> story/bug -> work items. However because the stories and bugs themselves are parent issues I end up with them being top-level groups on the board: I would much rather only see the parent issues grouped by those that are |
Beta Was this translation helpful? Give feedback.
-
You can create a sub-issue in a different repository, but you cannot add an existing one from the create sub-issue drop down when viewing an issue. This is a bit limiting. |
Beta Was this translation helpful? Give feedback.
-
When clicking the |
Beta Was this translation helpful? Give feedback.
-
When I want to add an existing issue as a sub-issue, I select the "Add existing issue" option. This opens a searchable list of suggested issues. This list also includes issues that are Closed. I've never had the need to add closed issues to an epic. To me it would make much more sense to only suggest open issues. |
Beta Was this translation helpful? Give feedback.
-
It would be helpful to be able to click the |
Beta Was this translation helpful? Give feedback.
-
Sub-issue webhook events are fired before the issue create webhook event if you create a new issue from the sub-issue button, this seems like incorrect behavior. |
Beta Was this translation helpful? Give feedback.
-
After setting a relation to the parent issue for an existing issue, I'm facing the following error: When I refresh the project page (F5), everything works as expected. |
Beta Was this translation helpful? Give feedback.
-
Hello, first of all, thanks a lot for this amazing feature! It is really helpful. It would be really nice to have that the start and end dates of a parent issue are automatically deduced from its sub-issues dates. Also, as others said, it could be very helpful to have and visualize dependencies between issues. |
Beta Was this translation helpful? Give feedback.
-
Is there any update as to when this will be available in GitHub CLI and/or GitHub Actions? It would be really useful to automatically create sub-issues in platform-specific repositories when an issue is created in the issue tracker repository. My preferred use-case would be: Issue tracker repo: This would allow me to have a clear overview on which platforms the feature is implemented, and maybe auto-close when all sub-issues are closed? (not sure if that's implemented already, but would be useful). |
Beta Was this translation helpful? Give feedback.
-
When using the GraphQL Explorer to try and list Sub_Issues in a Parent I get a return that Sub_Issue field is not valid on the type Issue: Query:
Response:
This query was taken from the documentation provided in the Beta Thread GraphQL API Click to view Fields and Mutations query summary { query parent { query subIssues { |
Beta Was this translation helpful? Give feedback.
-
In GitHub Projects, it would be great if sub-issues could be automatically nested with parent Issues in the Table view as accordion dropdowns. Currently, the layout is too flat to visually parse this hierarchy, and the additional 'parent' and 'sub-issue progress' columns are not sufficient for visual organization. |
Beta Was this translation helpful? Give feedback.
-
I really like the sub-issues feature so far. There is one thing I am missing though:
Use-Case: when I move an epic issue on a project board from one column to another, for example into the current sprint, I want the sub-issues to move along. Especially useful with the |
Beta Was this translation helpful? Give feedback.
-
Like the sub-issue so far! |
Beta Was this translation helpful? Give feedback.
-
Great job on this feature. In our Team we seriously think about using projects instead of Jira now, which shows how far you already brought GitHub Projects. We did find one thing missing: On our Board, we have tasks and subtasks You do have the field on the task that shows the parent issue, but what would be really great is some sort of bundling together When we use the grouping feature in then converts everything to swim lanes, which seems to be a bit odd, because eg. here you can see #8 is there as a swimlane but also unter So would be great if we could have the possibility to bundle the subtasks and parent together in the project view like shown in the screenshot from jira :) |
Beta Was this translation helpful? Give feedback.
-
Our org often has situations in our project tasking where labels and assignees in a parent issue should be gathered from sub-issues. Similarly to how @tk3fftk mentioned above that labels may inherit from parent- to sub-issues, it would be nice to have labels and assignees in a parent issue be a collection of the ones in the sub-issues so that sub-issue assignees are not lost in the Project view. Example:Current state⭕ Parent issue (no assignees)
Proposed structure⭕ Parent issue (Sabrina, Demi)
I think users could get around this by adding the sub-issues to the project separately and using grouping view to see them in drop-down form, but it seems intuitive that the parent issue, especially in a project view, would show all assignees of its sub-issues. |
Beta Was this translation helpful? Give feedback.
-
We have a table view that filters on |
Beta Was this translation helpful? Give feedback.
-
The grey color used for linked PR's in sub issues makes me assume they are draft PR's |
Beta Was this translation helpful? Give feedback.
-
Hello, it could be good to have a drag and drop functionality to migrate sub-issues from the current parent issue to another one. It could be also nice to have the possibility to assign automatically the status of a parent issue to all its sub-issues |
Beta Was this translation helpful? Give feedback.
-
Feedback wanted
Thank you for participating in the sub-issues public preview. Please leave your feedback below on what is working well, any bugs you encounter, and what else you’d like to see!
To provide your feedback on other experiences released at the same time, please visit:
Sub-issues
Sub-issues are designed to help you group and manage your issues with a parent/child relationship into a hierarchy.
Adding sub-issues
Any existing issue, where you have write access or above, will now have a 'create sub-issue' option, you can also use the drop down to opt to create an existing issue instead:
Alternatively, you will notice a new relationship section on the sidebar, allowing you to add from a child to a parent.
Viewing sub-issues
As you create sub-issues, you will start building a nested hierarchy of issues under your opening comment.
Clicking one of these issues now allows you to explore them directly from the main issue page via a slide out panel, making it easy to add a comment or update meta-data without losing context.
Working with sub-issues in projects
We have a couple of new fields in projects,
sub-issue progress
- which gives you a customisable (check out the settings page) progress pill or bar to see how your issues are progressing:And
parent issue
- helping you see what the parent item of each issue is. Which works especially well in a group by or slice by format:We will also shortly release a new workflow to keep a all child issues synced with a project which the parent already belongs to.
Webhooks
Sub-issue webhooks can be enabled at the repository or organization level and can be enabled/disabled separately from issue events.
Webhook events are now fired for the following actions:
GraphQL API
Sub-issues can also be managed via the GraphQL API. Note that these requests will need to include the
GraphQL-Features
header with a value ofsub_issues
.Click to view Fields and Mutations
Fields
subIssuesSummary
Summary of the state of an issue's sub-issues
parent
The parent entity of the issue.
subIssues
A list of sub-issues associated with the Issue.
Mutations
addSubIssue
Adds a sub-issue to a given issue
If you'd like to replace the exist parent of a sub-issue, provide
replaceParent: true
removeSubIssue
Removes a sub-issue from a given issue
reprioritizeSubIssue
Reprioritizes a sub-issue to a different position in the parent list.
Sub-issue limits
A couple of limits we have implemented that we would love feedback on:
Next Steps
We would love your feedback on sub-issues and the new issues experience in general as your try it out! Please let us know what you think! 🎉
Beta Was this translation helpful? Give feedback.
All reactions