Skip to main content

Managing teams and people with access to your repository

You can see everyone who has access to your repository and adjust permissions.

Who can use this feature?

People with admin access to a repository can manage teams and people with access to a repository.

About access management for repositories

For each repository that you administer on GitHub, you can see an overview of every team or person with access to the repository. From the overview, you can also invite new teams or people, change each team or person's role for the repository, or remove access to the repository.

This overview can help you audit access to your repository, onboard or off-board contractors or employees, and effectively respond to security incidents.

If a person has been given conflicting access, you'll see a warning on the repository access page. The warning appears with " Mixed roles" next to the person with the conflicting access. To see the source of the conflicting access, hover over the warning icon or click Mixed roles.

For more information about repository roles, see "Permission levels for a personal account repository" and "Repository roles for an organization."

Screenshot of the "Manage access" page for a repository.

Filtering the list of teams and people

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Access" section of the sidebar, click Collaborators & teams.

  4. Under "Manage access", in the search field, start typing the name of the team or person you'd like to find. Optionally, use the dropdown menus to filter your search.

Changing permissions for a team or person

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Access" section of the sidebar, click Collaborators & teams.

  4. Under "Manage access", next to the team or person whose role you'd like to change, select the Role dropdown menu, and click a new role.

Inviting a team or person

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Access" section of the sidebar, click Collaborators & teams.

  4. To the right of "Manage access", click Add people or Add teams.

  5. In the search field, start typing the name of the team or person to invite, then click a name in the list of matches.

  6. Under "Choose a role", select the repository role to grant to the team or person, then click Add NAME to REPOSITORY.

Removing access for a team or person

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Access" section of the sidebar, click Collaborators & teams.

  4. Under "Manage access", next to the team or person whose access you'd like to remove, click Remove.

Further reading