# Custom role

Facts read 16 Nov 2026. Page reviewed 16 Nov 2026.

A custom role is a role whose permission list the customer writes, used when no provider-supplied role matches the task. In Google Cloud it is a user-specified list of permissions; in Azure it is a role definition you create with chosen actions and assignable scopes.

## An example, sourced

Microsoft's documentation shows a custom role described as "Can monitor and restart virtual machines" with assignable scopes naming two subscriptions and one management group.

## Why it matters here

A custom role is the main way to land below a broad built-in role. It also needs upkeep, because new permissions are not added to it automatically.

## Related pages

- [Predefined role: meaning and an example](/glossary/predefined-role/)
- [Basic role: meaning and an example](/glossary/basic-role/)
- [Managed policy: meaning and an example](/glossary/managed-policy/)
- [All of them](/glossary/)

## Sources

- https://learn.microsoft.com/en-us/azure/role-based-access-control/custom-roles (read 16 Nov 2026)

Last reviewed 16 Nov 2026. Canonical: https://leastprivilegeprinciple.com/glossary/custom-role/
