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 upper-right corner of GitHub, select your profile photo, then click Your organizations.

  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 whose parent you'd like to change.

  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 either click a parent team, or, to remove an existing parent, click Clear selected value.

  7. Click Update.

  8. Read about the changed repository access permissions.

  9. Click Confirm new parent team.

Further reading