Teams give organizations the ability to create groups of members and control access to repositories. Team members can be granted read, write, or admin permissions to specific 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".

Teams can map to physical teams within your company, but they can also represent areas of interest or expertise. For example, a team of accessibility experts on your Enterprise instance could comprise people from several different departments. In this way, teams can represent functional concerns that complement a company's existing divisional hierarchy.

Creating a team

A prudent combination of teams is a powerful way to control repository access. For example, if your organization allows only your release engineering team to push code to the master branch of any repository, you could give only the release engineering team Push & Pull permissions to your organization's repositories and give all other teams Pull Only permissions.

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

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

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

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

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

  6. Select permission levels for the team. Team permission radio buttons

  7. Click Create team. Create team button