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, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Click the name of your organization. Organization name in list of organizations

  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

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.