Skip to main content

Requesting to add a child team

If you have maintainer permissions in a team, you can request to nest an existing team under your team in your organization’s hierarchy.

When you request to add a team as a child, a request is sent to the maintainers of the child team. Once a maintainer of the child team approves your request, the child team is nested under the parent team in your organization's hierarchy.

If you're an organization owner or you have team maintainer permissions in both the child team and the parent team, you can add the child team without requesting approval or change the child team's parent from the child 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 upper-right corner of GitHub.com, select your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  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 where you'd like to add the child team.

  5. At the top of the team page, click Teams.

    Screenshot of the header of a team's page. A tab, labeled with a people icon and "Teams", is outlined in dark orange.

  6. Click Add a team.

  7. Type the name of the team you'd like to add as a child team, and click the team in the results.

  8. Read about the changed repository access permissions.

  9. To send a request to add the child team, click Confirm changes.

Further reading