Creating custom organization roles in an enterprise

Create roles with fine-grained permissions for a consistent experience across your organizations.

To define consistent sets of permissions for settings and repositories, you can create custom organization roles for use in all of the enterprise's organizations. This allows centralized management of common roles such as "Developer" or "SRE team."

Custom organization roles created at the enterprise level use the same organization and repository permissions and base roles as roles created at the organization level. There is no difference in how these roles function or what they can allow. For more information, see About custom organization roles.

Enterprise owners can create and edit custom organization roles, but cannot assign them. Organization owners can assign custom roles in an organization.

Note

An enterprise can create up to 20 custom organization roles. This limit applies to the enterprise: each organization can also create up to 20 custom organization roles.

  1. In the top-right corner of GitHub, click your profile picture.
  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
  3. At the top of the page, click People.
  4. In the left sidebar, select Organization roles.
  5. Click Create custom role.
  6. Enter the details, then click Create role.