Creating teams

Use teams to manage permissions, notifications, and code ownership in your organizations.

Who can use this feature?

Organization owners can create teams and control whether all organization members can also create teams.

In this article

About teams

You can use teams to manage access for people in an organization. Teams are groups of organization members that reflect your company's structure with cascading access permissions.

Teams can:

  • Have admin, read, or write access to organization repositories
  • Receive notifications when the team's name is mentioned or when someone requests a review from the team
  • Be designated as owners of certain files in a CODEOWNERS file
  • Be made "secret" to hide membership from other members
  • Be synced with an identity provider group to manage membership centrally
  • Be children or parents of other teams, allowing permissions and notifications to be inherited

For more information, see See About teams and Setting team creation permissions in your organization.

Creating a team

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.

  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. At the top of the page, click New team.

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

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

  7. Optionally, if you're creating a child team, under "Parent team", select the Select a parent team dropdown menu and click a parent team. For more information about child teams, see About teams.

  8. Optionally, if your organization or enterprise account uses team synchronization or your enterprise uses Enterprise Managed Users, connect an identity provider group to your team.

    • If your enterprise uses Enterprise Managed Users, use the "Identity Provider Groups" drop-down menu, and select a single identity provider group to connect to the new team. For more information, Managing team memberships with identity provider groups.
    • If your organization or enterprise account uses team synchronization, under "Identity Provider Groups," select the Select Groups dropdown menu, and click up to five identity provider groups to connect to the new team. For more information, see Synchronizing a team with an identity provider group.

  9. Under "Team visibility", select a visibility for the team.

  10. Under "Team notifications", select Enabled or Disabled.

    Note

    This setting only applies to @mentions of the team name. This setting does not affect notifications for reviews requested from the team.

  11. Click Create team.

  12. Optionally, give the team access to organization repositories. For more information, see Managing team access to an organization repository.

Next steps

Next, learn about best practices for structuring your organizations and teams. See Best practices for organizations in your enterprise.