jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-19 18:10:59 -05:00
Code Issues Projects Releases Wiki Activity

Enterprise custom org roles (#57170)

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Sunbrye Ly <56200261+sunbrye@users.noreply.github.com>
Co-authored-by: sunbrye <sunbrye@github.com>
This commit is contained in:
Hirsch Singhal
2025-08-20 13:57:55 -07:00
committed by GitHub
parent 17b94abb5f
commit 125491e7fa
5 changed files with 26 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
content/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-organization-roles.md
View File

@@ -14,13 +14,15 @@ product: 'Organizations on {% data variables.product.prodname_ghe_cloud %}{% ifv
{% 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).
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 page you have access to.
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. With {% data variables.product.prodname_ghe_cloud %} and starting from {% data variables.product.prodname_ghe_server %} 3.19, if your enterprise owner has created organization roles, these roles can be seen and assigned as well, but not edited or deleted.
To{% ifversion org-pre-defined-roles %} view organization role permissions and{% endif %} manage organization role assignments, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles)
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 page you have access to.
To{% ifversion org-pre-defined-roles %} view organization role permissions and{% endif %} manage organization role assignments, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).
## Creating a custom role
Organization owners and users with the "Manage custom organization roles" permission can create up to 10 custom organization roles.
Organization owners and users with the "Manage custom organization roles" permission can create up to 20 custom organization roles. On {% data variables.product.prodname_ghe_server %} earlier than 3.19, you can create up to 10.
{% data reusables.profile.access_org %}
{% data reusables.profile.org_settings %}

2
content/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles.md
View File

@@ -21,7 +21,7 @@ You can have more granular, scalable control over the access you grant to your o
{% ifversion ghec or ghes %}
In addition to pre-defined roles, you can also create up to 10 custom roles that define groups of permissions. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).
In addition to pre-defined roles, you can also create up to 20 custom roles that define groups of permissions. Your enterprise owner can also create organization roles for you to use. On {% data variables.product.prodname_ghe_server %} earlier than 3.19, you can create up to 10 custom roles. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles) and [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-users-in-your-enterprise/roles-in-an-enterprise).
{% endif %}

2
content/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/about-custom-repository-roles.md
View File

@@ -20,7 +20,7 @@ To perform any actions on {% data variables.product.github %}, such as creating
Within an organization, you can assign roles at the organization, team, and repository level. For more information about the different levels of roles, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization).
You can have more granular control over the permissions you grant at the repository level by creating up to five custom repository roles. {% data reusables.organizations.about-custom-repo-roles %} For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-custom-repository-roles-for-an-organization).
You can have more granular control over the permissions you grant at the repository level by creating up to 20 custom repository roles. On {% data variables.product.prodname_ghe_server %} earlier than 3.19, you can create up to five custom repository roles. {% data reusables.organizations.about-custom-repo-roles %} For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-custom-repository-roles-for-an-organization).
After you create a custom role, anyone with admin access to a repository can assign the role to an individual or team. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-an-individuals-access-to-an-organization-repository) and [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-team-access-to-an-organization-repository).