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 child team. For more information, see "Requesting to add a child team."

Child teams inherit the access permissions of the parent team. For more info 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, 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

  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. Under the team name, 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 the information about changed repository access permissions, then click Confirm new parent team. Modal box with information about the changes in repository access permissions

Further reading