This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-05-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Article version: Enterprise Server 2.17

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 top right corner of GitHub Enterprise, 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 where you'd like to add the child team.
    List of the organization's teams
  5. At the top of the team page, click Teams.
    Teams tab on a team page
  6. Click Add a team.
    Add a team button on a team page
  7. Type the name of the team you'd like to add as a child team, and select it from the drop-down list.
    Text box to type and drop-down menu to select the name of the child team
  8. Read about the changed repository access permissions.
  9. Click Confirm changes to send a request to add the child team.
    Modal box with information about the changes in repository access permissions

Further reading

Ask a human

Can't find what you're looking for?

Contact us