Managing custom repository roles for an organization

Learn how to create, edit, or delete custom repository roles for your organization.

Who can use this feature?

Organization owners.

In this article

About custom repository roles

A custom repository role is a configurable set of permissions with a custom name you choose. For more information, see "About custom repository roles."

Creating a repository role

To create a new repository role, you add permissions to an inherited role and give the custom role a name.

  1. In the upper-right corner of GitHub, select your profile photo, then click Your organizations**.
  2. Under "Organizations", next to the name of your organization, click Settings.
  3. In the "Access" section of the sidebar, click Repository roles.
  4. Scroll to the "Custom roles" section, then click Create a Role.
  5. Under "Name", type the name of your repository role.
  6. Under "Description", type a description of your repository role.
  7. Under "Choose a role to inherit", select the role you want to inherit.
  8. Under "Add Permissions", select the dropdown menu and click the permissions you want your custom role to include.
  9. Click Create role.

Editing a repository role

  1. In the top right corner of GitHub, click your profile photo, then click Your profile.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your profile" is outlined in dark orange.

  2. In the upper-right corner of GitHub, select your profile photo, then click Your organizations**.

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  4. Under "Organizations", next to the name of your organization, click Settings.

  5. In the "Access" section of the sidebar, click Repository roles.

  6. To the right of the role you want to edit, click , then click Edit.

    Screenshot of the list of custom roles for an organization. To the right of a role, a kebab icon is outlined in dark orange.

  7. Edit, then click Update role.

Deleting a repository role

If you delete an existing repository role, all pending invitations, teams, and users with the custom role will be reassigned to the organization's base permissions.

  1. In the top right corner of GitHub, click your profile photo, then click Your profile.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your profile" is outlined in dark orange.

  2. In the upper-right corner of GitHub, select your profile photo, then click Your organizations**.

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

    Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.

  4. Under "Organizations", next to the name of your organization, click Settings.

  5. In the "Access" section of the sidebar, click Repository roles.

  6. To the right of the role you want to delete, click , then click Delete.

    Screenshot of the list of custom roles for an organization. To the right of a role, a kebab icon is outlined in dark orange.

  7. Review changes for the role you want to remove, then click Delete role.