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 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 on the organization page

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

  5. At the top of the team page, click Settings. Team settings tab

  6. Under "Parent team", use the "Select parent team" drop-down menu and click the name of the new parent team. Drop-down menu listing the organization's teams

  7. Click Save changes.
  8. Read the information about changed repository access permissions, then click Confirm changes to send a request to add or change your team's parent. Modal box with information about the changes in repository access permissions

Further reading