Skip to main content
All products
Organizations

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.com, click 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. Organization name in list of organizations

  3. Under your organization name, click Teams.

    Teams tab

  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. Click Create team.

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

Further reading