Sub-issues Public Preview

[github-staff]

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:

• Evolving GitHub Issues - Public Preview #148713
• Issue Types Public Preview #148715
• Advanced Search for Issues Public Preview #148716

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:

• Sub-issue added
• Sub-issue removed
• Parent issue added
• Parent issue removed

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 of sub_issues.

Click to view Fields and Mutations

Fields

subIssuesSummary

Summary of the state of an issue's sub-issues

query summary {
  node(id: "I_123") {
    ... on Issue {
      subIssuesSummary {
        total
        completed
        percentCompleted
      }
    }
  }
}

parent

The parent entity of the issue.

query parent {
  node(id: "I_456") {
    ... on Issue {
      parent {
        title
      }
    }
  }
}

subIssues

A list of sub-issues associated with the Issue.

query subIssues {
  node(id: "I_123") {
    ... on Issue {
      subIssues(first: 10) {
        nodes {
          title
        }
      }
    }
  }
}

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

mutation addSubIssue {
  addSubIssue(input: { issueId: "I_123", subIssueId: "I_456" }) {
    issue {
      title
    }
    subIssue {
      title
    }
  }
}

removeSubIssue

Removes a sub-issue from a given issue

mutation removeSubIssue {
  removeSubIssue(input: { issueId: "I_123", subIssueId: "I_456" }) {
    issue {
      title
    }
    subIssue {
      title
    }
  }
}

reprioritizeSubIssue

Reprioritizes a sub-issue to a different position in the parent list.

mutation reprioritizeSubIssue {
  reprioritizeSubIssue(
    input: { issueId: "I_123", subIssueId: "I_456", afterId: "I_789" }
  ) {
    issue {
      title
    }
  }
}

Sub-issue limits

A couple of limits we have implemented that we would love feedback on:

• Sub-issue depth limit: 8
• Max sub-issues per level: 100
• Parents are unique ( an issue can only have one parent)

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! 🎉

[huehnerlady]

Hi,

Unfortunately my feedback from here seem not to be implemented yet?

For us that is actually a key feature to be able to use the github issues and move away from Jira 😅

[evi-liu]

Hi @huehnerlady, appreciate the helpful feedback! As you can imagine, we have dozens of feature requests and we prioritize based on customer demand. Unfortunately, we haven't heard enough critical mass of feedback regarding sub-issue bundling on the board view to prioritize it just yet.

In the meantime, I'd suggest using the Table layout with Group by parent issue to see the bundling of sub-issues and parent issues.

[huehnerlady]

We have 2 boards in Jira, one is like I ask you to and one is like you suggest. The table version so far does not work for us unfortunately and we think about getting rid of that. So we need to wait for this feature in order to be able to migrate over 😅

[mavericreal]

Great point. Similar feedback here, but specific to the roadmap view rather than the board view: https://github.com/orgs/community/discussions/148714#discussioncomment-11851148

[tiarakelly]

I've noticed that clicking on the sub-issue progress bar retains the same filter query of the project view. This produces an empty view if the project view was set to show type:features to show the parent child relationship and the child is an epic that type:task.

[tmelliottjr]

👋🏻 Hi there!

Thanks so much for the feedback, this is actually working as currently intended even if a bit odd at first glance.

The parent issue filter is appended to any existing filters for the view and as such, that may result in no parent issue matching the filter criteria.

An alternative we've discussed is replacing the filter entirely with only the parent issue filter. However, it might be more jarring for potentially carefully crafted filters to be removed this way.

I'm going to raise this again with the team as it's not the first time we've seen this feedback.

[tiarakelly]

This is an example of my use case.

Project filter with grouping by parent issue. Here I would also like to click the progress bar and see all child issues.

When looking at a sub-issue if I click on the progress bar, I expect to see all the child issues not just the level:feature issues.

This is what actually happens:

I want to see this

[JamesonRGrieve]

CCing because it wasn't answered in the previous thread and we are now yet another thread down the link-chain.

Your issue for issue dependencies was closed with a forwarding issue (eventually ending up here), but I can't find any other reference to this in the issue it links to, or here which is linked therefrom. What happened to that feature?

[evi-liu]

Hi @JamesonRGrieve, the Dependencies issue is still on our roadmap! Here is the roadmap issue: github/roadmap#1076

[JamesonRGrieve]

Thanks @evi-liu - it might be prudent to have someone link that as a forwarding issue on the issue I linked since that is the first thing that comes up on Google when you search "github issue dependency".

[mavericreal]

Sub-issues in VS Code GitHub Extension

I imagine this is managed by a different team, but since it's highly relevant, I’m linking a related feature request here.

The request suggests enabling the ability to edit and visualize sub-issues directly from the code editor, which could greatly enhance productivity for developers.

You can find the feature request here: microsoft/vscode-pull-request-github#6596

[mavericreal]

Unfold children in roadmap view within projects

It would be great if in a GitHub project with a roadmap view, it was possible to see the children unfolded. Currently, having to open them one by one makes it harder to maintain the hierarchy and get a clear overview of dependencies or sub-tasks.

This feature would improve usability by:

• Preserving the task hierarchy in the roadmap view.
• Reducing the need for repetitive clicks to expand child items.
• Providing a comprehensive overview of tasks and their relationships.

Consider adding an option to toggle "Unfold All" for easier navigation and management.

[tom-rm-meyer-ISST]

Relax linking restrictions between sub-issues across organizations and users

We do planning stuff across organizations. Different persons create issues that may be linked across the organization to a ticket that had not been created by the same person.

The linkage popup allows to find these strories but does not allow linkage as either the creator OR the organization needs to the same:

I think the restriction to same organization OR user can be relaxed to some logic like "A user is allowed to link, if"

• the user, who tries to link, has the rights to handle sub-issues on both repositories
• the user, who tries to link, shares a team in one of the involved organizations
• the users, who created both issues, are in both organizations

Maybe also I misunderstood the message

[rik]

Keyboard shortcuts clashing

In an issue comment textarea, I can't type the characters Ç and Å on my computer (macOS with English keyboard layout). The keyboard shortcuts for "Create sub-issue" (Opt-Shift-C) and "Add existing issue" (Opt-Shift-A) take precedence when they should not.

[tmelliottjr]

👋🏻 Thanks for raising this, that certainly should not be happening. I'll forward this to the team for fixing.

[tmelliottjr]

@rik Thanks again for raising this. The shortcuts should now be ignored when editing content. Let us know if that is not the case for you.

[rik]

All good! Thank you for a quick turnaround.

[hgenbw]

GroupBy parent issue results on several entries if there is a hierarchy of more than 1-n.
Lets say Goal-Initiative-Task will result in one Group per Initiative with all the Tasks of it and then another group of the goal with all its initiatives.
It will not be ordered.

The ideal behaviour would be to display the groups hierarchically.

[emhane]

labels should be visible on sub-issues, as they are on [tasklist]

[odungern]

Don't see the "Create more sub-issues" button as described in the docu. After creating the first sub-issue, further sub-issues at lower level can be added, but not at the top-level.

Expectation: See the same button 'create sub-issue' as before at the top-level issue.

[tmelliottjr]

When creating a sub-issue a new create issue dialog is shown. At the bottom, you should see a Create more sub-issues checkbox as shown in this screenshot. Please let me know if that's not the case.

[justyn]

Group by: parent issue in Projects has problems

Currently if you "group by: parent issue" it will combine the child issues under their parents in a collapsible way, with a nice progress bar (see screenshot).

But there's a problem with this view, because the "grouped by" headings here "stand in" for the actual parent issue but are not issue lines themselves.

You're therefore forced to either:

• Have duplication of the parent issue (as a grouped by header, and as the issue itself, see screenshot under "no parent issue")
• Exclude the parent issues from the filters for the view, so they are only seen as grouped-by headers, in which case any parent issue (eg an Epic) without any children yet doesn't get displayed at all and so can be forgotten.

I propose a new dedicated view mode for handling the hierarchical grouping of parents, sub-issues whilst allowing the parent issue to remain a regular issue line (with fields) and avoiding duplication.

[tmelliottjr]

👋 This is great feedback and something we've discussed for future improvements to Sub-issues within Projects. We don't have a timeline for such changes, but this is most certainly on our radar.

[cmwilson21]

Is this down right now? I have issues that we created sub-issues on and they are not showing up in the parent issue right now.

[cmwilson21]

They are back now but they were gone for at least an hour that I noticed.