Skip to main content

Organizing members into teams

You can group organization members into teams that reflect your company or group's structure with cascading access permissions and mentions.

About teams

Teams are groups of organization members that reflect your company or group's structure with cascading access permissions and mentions.

Creating a team

You can create independent or nested teams to manage repository permissions and mentions for groups of people.

Adding organization members to a team

People with owner or team maintainer permissions can add organization members to teams. People with owner permissions can also add non-members to a team and the organization.

Assigning the team maintainer role to a team member

You can give a team member the ability to manage team membership and settings by assigning the team maintainer role.

Setting your team's profile picture

Team maintainers and organization owners can set a profile picture for a team, which is displayed on the team's page.

Managing code review settings for your team

You can decrease noise for your team by limiting notifications when your team is requested to review a pull request.

Renaming a team

Team maintainers and organization owners can edit the name and description of a team.

Changing team visibility

Team maintainers and organization owners can determine whether a team is visible or secret.

Configuring team notifications

Team maintainers and organization owners can configure notifications for specific teams.

Synchronizing a team with an identity provider group

You can synchronize a GitHub Enterprise Server team with a supported identity provider (IdP) group to automatically add and remove team members.

Moving a team in your organization’s hierarchy

Team maintainers and organization owners can nest a team under a parent team, or change or remove a nested team's parent.

Requesting to add a child team

If you have maintainer permissions in a team, you can request to nest an existing team under your team in your organization’s hierarchy.

Requesting to add or change a parent team

If you have maintainer permissions in a team, you can request to nest your team under a parent team in your organization's hierarchy.

Removing organization members from a team

People with owner or team maintainer permissions can remove team members from a team. This may be necessary if a person no longer needs access to a repository the team grants, or if a person is no longer focused on a team's projects.

Deleting a team

Organization owners can delete teams at any time from the team's settings page.