Managing custom repository roles for an organization

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.

   

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.

   

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.

   

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.

   

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.

   

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.

   

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