👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.
Article version: GitHub.com

Creating a team

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

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."

You can use team synchronization to automatically add and remove team members in an organization through an identity provider. For more information, see "Synchronizing a team with an identity provider group."

  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

  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. Optionally, if your organization or enterprise account uses team synchronization, to connect an identity provider group to your team, use the "Identity Provider Groups" drop-down menu, and select up to 5 identity provider groups. For more information, see "Synchronizing a team with an identity provider group."

    Drop-down menu to choose identity provider groups

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

    Options for visibility including visible and secret

  10. Click Create team.

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

Further reading

Ask a human

Can't find what you're looking for?

Contact us