Skip to main content

Using organization roles

You can use pre-defined organization roles to provision sets of permissions for your users.

Who can use this feature?

Organization owners

Organizations on GitHub Free, GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server

About organization roles

You can have more granular, scalable control over the access you grant to your organization's resources using organization roles. Organization roles grant an organization member or team the ability to take specific actions or manage some settings without granting full administrative control of the organization and its repositories.

About pre-defined organization roles

Pre-defined organization roles are roles that are available by default in every organization - no need to create them yourself. They can include both organization permissions that let the recipient manage the organization, as well as repository permissions that apply to all of the repositories in the organization. The following pre-defined roles are built into every organization based on common patterns of permissions organizations usually need.

The current set of pre-defined roles are:

  • All-repository read: Grants read access to all repositories in the organization.
  • All-repository write: Grants write access to all repositories in the organization.
  • All-repository triage: Grants triage access to all repositories in the organization.
  • All-repository maintain: Grants maintenance access to all repositories in the organization.
  • All-repository admin: Grants admin access to all repositories in the organization.

Viewing organization role permissions

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
  2. Next to the organization, click Settings.
  3. In the "Access" section of the left sidebar, click Organization roles. Then click Role management.
  4. To the right of any role, click .
  5. Optionally, to hide the role permissions again, click .

Assigning an organization role

A user or team can have multiple organization roles. However, you can only assign one role at a time. To assign multiple roles to the same user or team, repeat the following instructions for each role you want to assign.

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
  2. Next to the organization, click Settings.
  3. In the "Access" section of the sidebar, click Organization roles, then click Role assignments.
  4. Click New role assignment.
  5. Search for users or teams that you want to assign a role to, then select the role you want to give to these users and teams.
  6. Click Add new assignment.

Viewing organization role assignments

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
  2. Next to the organization, click Settings.
  3. In the "Access" section of the sidebar, click Organization roles, then click Role assignments.
  4. Optionally, to filter by role assignments for users, click the Users tab. To filter by role assignments for teams, click the Teams tab.
  5. To view role assignments, to the right of the user or team, click NUMBER roles.

Deleting an organization role assignment

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations.
  2. Next to the organization, click Settings.
  3. In the "Access" section of the sidebar, click Organization roles, then click Role assignments.
  4. Optionally, to filter by role assignments for users, click the Users tab. To filter by role assignments for teams, click the Teams tab.
  5. To delete a role, to the right of the role, click NUMBER roles. Then click Remove.
  6. In the pop-up window, click Remove.