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 organization members to teams 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 organizations. Your organizations in the profile menu

  2. Click the name of your organization. Organization name in list of organizations

  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

Did this doc help you?Privacy policy

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.