Skip to main content
GitHub AE is currently under limited release.
All products
Enterprise administrators

Creating teams

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 information, see "Roles in an organization."

A team can represent a group within your company or include people with certain interests or expertise. For example, a team of accessibility experts on your enterprise could comprise of people from several different departments. Teams can represent functional concerns that complement a company's existing divisional hierarchy.

Organizations can create multiple levels of nested teams to reflect a company or group's hierarchy structure. For more information, see "About teams."

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 default branch of any repository, you could give only the release engineering team admin permissions to your organization's repositories and give all other teams read permissions.

  1. In the top right corner of GitHub AE, 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. Under "Team visibility", select a visibility for the team.

  8. 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."

  9. Click Create team.