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 teams between your identity provider and GitHub."

  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. Decide whether the team will be visible or secret.

    Options for visibility including visible and secret

  9. Click Create team.

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

Further reading

Ask a human

Can't find what you're looking for?

Contact us