Nested teams add depth to your team structure
Now you can use multiple levels of nested teams to reflect your group or company’s hierarchy within your GitHub organization, making your organization’s permissions structure clearer and easier to manage.…
Now you can use multiple levels of nested teams to reflect your group or company’s hierarchy within your GitHub organization, making your organization’s permissions structure clearer and easier to manage.
Child teams inherit their parent’s access permissions, so repository permissions and @mentioning among nested teams work from top to bottom. If your team structure is Employees > Engineering > Application Engineering > Identity, granting Engineering write access to a repository means Application Engineering and Identity also get that access. And if you @mention the Identity Team or any other team at the bottom of the organization hierarchy, they’re they only ones who will receive a notification.
Membership inheritance from parent to child teams isn’t automatic. If you’re a member of Engineering and someone creates a child team called Security, team members of Engineering aren’t automatically direct team members of Security. Security and all other teams nested under the Engineering will inherit repository permissions and @mentions but nothing else.
Check out the documentation to learn more and start structuring your existing teams!
Written by
Related posts

Explore the best of GitHub Universe: 9 spaces built to spark creativity, connection, and joy
See what’s happening at Universe 2025, from experimental dev tools and career coaching to community-powered spaces. Save $400 on your pass with Early Bird pricing.

Agents panel: Launch Copilot coding agent tasks anywhere on GitHub
Delegate coding tasks to Copilot and track progress wherever you are on GitHub. Copilot works in the background, creates a pull request, and tags you for review when finished.

Q1 2025 Innovation Graph update: Bar chart races, data visualization on the rise, and key research
Discover the latest trends and insights on public software development activity on GitHub with the quarterly release of data for the Innovation Graph, updated through March 2025.