This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-05-23. 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. For help with the upgrade, contact GitHub Enterprise support.

Article version: Enterprise Server 2.17

Moving a team in your organization’s hierarchy

Team maintainers and organization owners can nest a team under a parent team, or change or remove a nested team's parent.

Organization owners can change the parent of any team. Team maintainers can change a team's parent if they are maintainers in both the child team and the parent team. Team maintainers without maintainer permissions in the child team can request to add a parent or child team. For more information, see "Requesting to add or change a parent team" and "Requesting to add a child team."

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

Tips:

  • You cannot change a team's parent to a secret team. For more information, see "About teams."
  • You cannot nest a parent team beneath one of its child teams.
  1. In the top right corner of GitHub Enterprise, click your profile photo, then click Your profile.
    Profile photo
  2. On the left side of your profile page, under "Organizations", click the icon for your organization.
    organization icons
  3. Under your organization name, click Teams.
    Teams tab on the organization page
  4. In the list of teams, click the name of the team whose parent you'd like to change.
    List of the organization's teams
  5. At the top of the team page, click Settings.
    Team settings tab
  6. Use the drop-down menu to choose a parent team, or to remove an existing parent, select Clear selected value.
    Drop-down menu listing the organization's teams
  7. Click Update.
  8. Read about the changed repository access permissions.
  9. Click Confirm new parent team.
    Modal box with information about the changes in repository access permissions

Further reading

Ask a human

Can't find what you're looking for?

Contact us