Skip to main content

This version of GitHub Enterprise Server will be discontinued on 2024-03-07. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Requesting to add or change a parent team

If you have maintainer permissions in a team, you can request to nest your team under a parent team in your organization's hierarchy.

When you request to add or change your team's parent, a request is sent to the maintainers of the parent team. When a maintainer of the new parent team approves your request, your team is nested as a child team under the parent team in your organization's hierarchy.

If you're an organization owner or you have team maintainer permissions in the child team and the parent team, you can add the parent team without requesting approval or change your team's parent from your team's settings page. For more information, see "Moving a team in your organization’s hierarchy."

Child teams inherit the access permissions of the parent team. For more information on team hierarchies, see "About teams."

  1. In the upper-right corner of GitHub Enterprise Server, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. In the list of teams, click the name of the team you'd like to nest under a parent.

  5. At the top of the team page, click Settings.

    Screenshot of the header of a team's page. A tab, labeled with a gear icon and "Settings", is outlined in dark orange.

  6. Under "Parent team", select the Select a parent team dropdown menu and click the name of the new parent team.

  7. Click Save changes.

  8. Read about the changed repository access permissions.

  9. To send a request to add or change your team's parent, click Confirm changes.

Further reading