Skip to main content

This version of GitHub Enterprise was discontinued on 2023-07-06. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

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.

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 Enterprise Server, click your profile photo, then click Your organizations.

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

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

  2. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations.

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

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

    Screenshot of the horizontal navigation bar for an organization. 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 Enterprise Server, click your profile photo, then click Your profile.

  2. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations.

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

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

    Screenshot of the horizontal navigation bar for an organization. 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.