Teams give organizations the ability to create groups of members and control access to repositories.

Teams are central to many of GitHub's collaborative features, such as team @mentions to notify appropriate parties that you'd like to request their input or attention. For more details on how you can use organizations and teams to control repository access, see "Permission levels for an organization repository".

Creating a team

As an organization owner, you can create any number of teams. You can also associate more than one team with any user account or repository. A prudent combination of teams is a powerful way to control repository access. For example, if your organization allows only certain members to push code to the master branch of any repository, you could give only members of that "core" team Push & Pull permissions to your organization's repositories and give all other teams Pull Only permissions.

  1. highlighted usernameIn the top right corner of any page, click your username.

  2. organization iconsOn the left side of your profile page, under "Organizations", click the icon for your organization.

  3. Team panel with New Team button selectedOn the right side of the organization profile page, under Teams, click Create new team.

  4. Team name fieldOn the "Create new team" page, type the name for your new team.

  5. Team description fieldOptionally, in the "Description" field, type a description of the team.

  6. Team permission radio buttonsSelect permission levels for the team.

  7. Create team buttonClick Create team.