This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-11-12. 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.

Creating a team

You can create independent or nested teams to manage repository permissions and mentions for groups of people.

Did this doc help you?

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.

Only organization owners and maintainers of a parent team can create a new child team under a parent. Owners can also restrict creation permissions for all teams in an organization. For more information, see "Setting team creation permissions in your organization."

  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

  4. On the right side of the Teams tab, click New team.

    New team button

  5. Under "Create new team", type the name for your new team.

    Team name field

  6. Optionally, in the "Description" field, type a description of the team.

    Team description field

  7. Optionally, if you're creating a child team, use the drop-down menu to choose a parent team for your new team.

    Drop-down menu listing the organization's existing teams

  8. Decide whether the team will be visible or secret.

    Options for visibility including visible and secret

  9. Click Create team.

  10. Optionally, give the team access to organization repositories.

Further reading

Did this doc help you?

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.