Skip to main content

Managing custom repository roles for an organization

You can create, edit, or delete custom repository roles for your organization.

Who can use this feature

Organization owners can manage custom repository roles.

Note: Only organizations that use GitHub Enterprise Cloud can create custom repository roles. For more information about how you can try GitHub Enterprise Cloud for free, see "Setting up a trial of GitHub Enterprise Cloud."

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 top right corner of GitHub.com, click your profile photo, then click Your profile. Profile photo

  2. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  3. Under your organization name, click Settings.

    Organization settings button

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

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

  6. Click Create a Role. Screenshot of "Create a Role" button

  7. Under "Name", type the name of your repository role. Field to type a name for the repository role

  8. Under "Description", type a description of your repository role. Field to type a description for the repository role

  9. Under "Choose a role to inherit", select the role you want to inherit. Selecting repository role base role option

  10. Under "Add Permissions", use the drop-down menu to select the permissions you want your custom role to include. Selecting permission levels from repository role drop-down

  11. Click Create role. Confirm creating a repository role

Editing a repository role

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

  2. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  3. Under your organization name, click Settings.

    Organization settings button

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

  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. Edit option in drop-down menu for repository roles

  7. Edit, then click Update role. Edit fields and update repository roles

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.com, click your profile photo, then click Your profile. Profile photo

  2. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu

  3. Under your organization name, click Settings.

    Organization settings button

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

  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. Edit option in drop-down menu for repository roles

  7. Review changes for the role you want to remove, then click Delete role. Confirm deleting a repository role