Using organization roles

Learn how to manage organization role assignments.

Who can use this feature?

Organization owners

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

In this article

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.

In addition to pre-defined roles, you can also create up to 10 custom roles that define groups of permissions. For more information, see "About custom organization roles."

Assigning an organization role

The "Manage custom organization roles" permission does not allow a user to assign 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.