Verwaltung benutzerdefinierter Organisationsrollen

About custom organization roles

You can have more granular control over the access you grant to your organization's settings by creating custom organization roles. A custom organization role is a way to grant an organization member the ability to administer certain subsets of settings without granting full administrative control of the organization and its repositories. For example, you could create a role that contains the "View organization audit log" permission. For more information, see "About custom organization roles."

If you are an organization owner or have a custom role with the "View organization roles" or "Manage custom organization roles" permissions, you can view custom roles for the organization. To find the "Custom roles" page, you can follow the first steps in "Creating a custom role." The exact steps will vary depending on which other settings pages you have access to.

Creating a custom role

Organization owners and users with the "Manage custom organization roles" permission can create a custom organization role. You can create up to 10 custom roles in an organization.

1. In the upper-right corner of GitHub.com, 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 Custom roles.

4. Click Create a role.

5. Type a name and description for the custom role.

6. Under "Add permissions", click the text field, then select the permissions you want to add to the custom role. For more information about the available permissions, see "About custom organization roles."

7. Click Create role.

Assigning an organization role

Organization owners can assign a custom organization role to a user or team. The "Manage custom organization roles" permission does not allow a user to assign a custom role.

A user or team can have multiple custom 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.com, 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

Organization owners can see which roles are assigned to users and teams.

1. In the upper-right corner of GitHub.com, 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 organization role assignments

Organization owners can delete a role assignment for a user or team.

1. In the upper-right corner of GitHub.com, 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 Remove.

Editing a custom role

Organization owners and users with the "Manage custom organization roles" permission can edit a custom organization role.

1. In the upper-right corner of GitHub.com, 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 Custom roles.

4. Next to the role you want to edit, select , then click Edit role.

   

5. Change the role as required, then click Update role.

Deleting a custom role

Organization owners and users with the "Manage custom organization roles" permission can delete a custom organization role.

1. In the upper-right corner of GitHub.com, 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 Custom roles.

4. Next to the role you want to edit, select , then click Delete role.

   

5. Read the details in the dialog to confirm you want to delete the role, then click Delete role.