Skip to main content

Creating a team

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

Who can use this feature?

Organization owners can create teams and can control whether all organization members can also create teams. For more information, see "Setting team creation permissions in your organization."

Organizations that use GitHub Enterprise Cloud 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" in the GitHub Enterprise Cloud documentation.

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

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  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. Under "Team visibility", select a visibility for the team.

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

  10. Click Create team.

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