|
| 1 | +--- |
| 2 | +title: Managing custom organization roles |
| 3 | +intro: "You can create, edit, and assign custom organization roles in an organization's settings." |
| 4 | +versions: |
| 5 | + feature: 'custom-org-roles' |
| 6 | +topics: |
| 7 | + - Organizations |
| 8 | +shortTitle: Manage custom roles |
| 9 | +--- |
| 10 | + |
| 11 | + |
| 12 | +{% data reusables.organizations.custom-org-roles-ghec-only %} |
| 13 | + |
| 14 | +## About custom organization roles |
| 15 | + |
| 16 | +{% data reusables.organizations.custom-org-roles-intro %} For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)." |
| 17 | + |
| 18 | +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](#creating-a-custom-role)." The exact steps will vary depending on which other settings pages you have access to. |
| 19 | + |
| 20 | +## Creating a custom role |
| 21 | + |
| 22 | +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. |
| 23 | + |
| 24 | +{% data reusables.profile.access_org %} |
| 25 | +{% data reusables.profile.org_settings %} |
| 26 | +{% data reusables.organizations.custom-org-roles-settings-step %} |
| 27 | +1. Click **Create a role**. |
| 28 | +1. Type a name and description for the custom role. |
| 29 | +1. 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 "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#additional-permissions-for-custom-roles)." |
| 30 | +1. Click **Create role**. |
| 31 | + |
| 32 | +## Assigning an organization role |
| 33 | + |
| 34 | +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. |
| 35 | + |
| 36 | +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. |
| 37 | + |
| 38 | +{% data reusables.profile.access_org %} |
| 39 | +{% data reusables.profile.org_settings %} |
| 40 | +1. In the "Access" section of the sidebar, click **{% octicon "organization" aria-hidden="true" %} Organization roles**, then click **Role assignments**. |
| 41 | +1. Click **New role assignment**. |
| 42 | +1. 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. |
| 43 | +1. Click **Add new assignment**. |
| 44 | + |
| 45 | +## Viewing organization role assignments |
| 46 | + |
| 47 | +Organization owners can see which roles are assigned to users and teams. |
| 48 | + |
| 49 | +{% data reusables.profile.access_org %} |
| 50 | +{% data reusables.profile.org_settings %} |
| 51 | +1. In the "Access" section of the sidebar, click **{% octicon "organization" aria-hidden="true" %} Organization roles**, then click **Role assignments**. |
| 52 | +{% data reusables.organizations.custom-org-roles-filter %} |
| 53 | +1. To view role assignments, to the right of the user or team, click **NUMBER roles**. |
| 54 | + |
| 55 | +## Deleting organization role assignments |
| 56 | + |
| 57 | +Organization owners can delete a role assignment for a user or team. |
| 58 | + |
| 59 | +{% data reusables.profile.access_org %} |
| 60 | +{% data reusables.profile.org_settings %} |
| 61 | +1. In the "Access" section of the sidebar, click **{% octicon "organization" aria-hidden="true" %} Organization roles**, then click **Role assignments**. |
| 62 | +{% data reusables.organizations.custom-org-roles-filter %} |
| 63 | +1. To delete a role, to the right of the role, click **Remove**. |
| 64 | + |
| 65 | +## Editing a custom role |
| 66 | + |
| 67 | +Organization owners and users with the "Manage custom organization roles" permission can edit a custom organization role. |
| 68 | + |
| 69 | +{% data reusables.profile.access_org %} |
| 70 | +{% data reusables.profile.org_settings %} |
| 71 | +{% data reusables.organizations.custom-org-roles-settings-step %} |
| 72 | +1. Next to the role you want to edit, select {% octicon "kebab-horizontal" aria-label="Show custom role actions" %}, then click **Edit role**. |
| 73 | + |
| 74 | +  |
| 75 | + |
| 76 | +1. Change the role as required, then click **Update role**. |
| 77 | + |
| 78 | +## Deleting a custom role |
| 79 | + |
| 80 | +Organization owners and users with the "Manage custom organization roles" permission can delete a custom organization role. |
| 81 | + |
| 82 | +{% data reusables.profile.access_org %} |
| 83 | +{% data reusables.profile.org_settings %} |
| 84 | +{% data reusables.organizations.custom-org-roles-settings-step %} |
| 85 | +1. Next to the role you want to edit, select {% octicon "kebab-horizontal" aria-label="Show custom role actions" %}, then click **Delete role**. |
| 86 | + |
| 87 | +  |
| 88 | + |
| 89 | +1. Read the details in the dialog to confirm you want to delete the role, then click **Delete role**. |
0 commit comments