---
title: Shared Roles
description: >-
  Define a custom role once in an organization group's owner organization,
  provision it to every member organization, and control whether member
  organizations can create their own custom roles.
breadcrumbs: Docs > Account Management > Shared Roles
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Shared Roles

## Overview{% #overview %}

With shared roles, administrators in the owner organization of an [organization group](https://docs.datadoghq.com/account_management/organization_groups.md) define a custom role once. Datadog provisions it into every member organization in the group. Use shared roles to keep role definitions consistent across organizations, instead of maintaining the same role in each one.

In each member organization, a shared role behaves like a [Datadog managed role](https://docs.datadoghq.com/account_management/rbac.md#datadog-default-roles), except that the organization group manages it instead of Datadog. Member organization administrators assign the role to users and teams but cannot edit or delete it. Changes made at the group level propagate to every member organization, and organizations that join the group later receive the group's shared roles.

To also stop member organizations from creating their own custom roles, set the group's role exclusivity to Strict.

## How shared roles work{% #how-shared-roles-work %}

In a member organization, shared roles appear on the Roles page with the type Group Managed. Other roles show the type Custom or Datadog Managed.

{% image
   source="https://docs.dd-static.net/images/account_management/org-groups-shared-roles-member-org.282fd49136912412e98c325aec030c65.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/account_management/org-groups-shared-roles-member-org.282fd49136912412e98c325aec030c65.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Roles page in a member organization, with Datadog Managed, Group Managed, and Custom roles in the Type column." /%}

Shared roles are always Group Managed. Unlike [organization group policies](https://docs.datadoghq.com/account_management/organization_groups.md#organization-group-policies), they have no Override Allowed tier, so a member organization cannot change a shared role's permissions for itself. To give one member organization a variation of a shared role, create a separate shared role. If role exclusivity is Flexible, the member organization can also clone the shared role into a custom role and edit the clone.

Role assignment stays with each member organization's administrators. Administrators in the owner organization cannot assign roles to users in member organizations, or see which users in member organizations have a shared role.

If an organization leaves the group, its shared roles become regular custom roles.

## Role exclusivity{% #role-exclusivity %}

Role exclusivity controls whether member organizations can create their own custom roles in addition to using the group's shared roles. Set it in the Role Exclusivity section of the group's Roles tab.

| Setting  | Behavior in member organizations                                                                                                  |
| -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Flexible | Member organizations can create, clone, and edit their own custom roles, and use shared roles.                                    |
| Strict   | Member organizations can use only shared roles and Datadog managed roles. Creating, cloning, and editing custom roles is blocked. |

{% image
   source="https://docs.dd-static.net/images/account_management/org-groups-shared-roles-exclusivity.96c03347334526c928cf6e5715c0b5fd.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/account_management/org-groups-shared-roles-exclusivity.96c03347334526c928cf6e5715c0b5fd.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Roles tab of an organization group, with Strict selected in the Role Exclusivity section." /%}

When role exclusivity is Strict:

- **Existing custom roles are frozen, not removed.** They become read-only, and users and teams that have them keep their access. Member organization administrators can still assign them.
- **Deleting custom roles stays available**, because deleting a role only removes access.
- **The restrictions also apply to the API and Terraform.** Terraform applies that create or modify custom roles in member organizations fail.
- **The owner organization is included** if it is a member of its own group.

{% image
   source="https://docs.dd-static.net/images/account_management/org-groups-shared-roles-strict-member.d97407cd2086d406196917c36684bd42.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/account_management/org-groups-shared-roles-strict-member.d97407cd2086d406196917c36684bd42.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Roles page in a member organization of a Strict group, with the New Role button disabled and a Group Managed tooltip." /%}

Switching a group back to Flexible lets member organizations create and edit custom roles again, including frozen ones.

{% alert level="info" %}
Before you switch a group to **Strict**, create shared roles that cover the access member organizations need, and assign them to users and teams.
{% /alert %}

## Manage shared roles{% #manage-shared-roles %}

Manage shared roles from the Roles tab of an organization group in the owner organization.

{% image
   source="https://docs.dd-static.net/images/account_management/org-groups-shared-roles-tab.e488e13a39df68d02b1f9c78a29a33a8.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/account_management/org-groups-shared-roles-tab.e488e13a39df68d02b1f9c78a29a33a8.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="The Shared Roles list on an organization group's Roles tab, with a Group Managed role and the Add Role button." /%}

### Create a shared role{% #create-a-shared-role %}

1. In the owner organization, go to Organization Settings > Organization Groups.
1. Select the organization group.
1. Open the Roles tab.
1. Click Add Role.
1. Enter a name for the role.
1. Select the permissions for the role. See [Datadog Role Permissions](https://docs.datadoghq.com/account_management/rbac/permissions.md).
1. Save the role.

If a member organization already has a role with the same name, Datadog blocks the operation. See Resolve a role name conflict.

To start from an existing shared role, click Clone on that role in the Shared Roles list.

### Edit or rename a shared role{% #edit-or-rename-a-shared-role %}

1. On the group's Roles tab, find the role in the Shared Roles list.
1. Click Edit.
1. Change the name or the permissions.
1. Save your changes.

### Disable a shared role{% #disable-a-shared-role %}

Shared roles cannot be deleted, because deleting a shared role could cause users in member organizations to lose access unexpectedly. To stop managing a role from the group, disable it.

{% alert level="warning" %}
Disabling a shared role is permanent. You cannot re-enable a disabled shared role.
{% /alert %}

1. On the group's Roles tab, find the role in the Shared Roles list.
1. Click Disable.
1. Confirm your decision.

When you disable a shared role, Datadog does not delete it from member organizations. In each member organization, it becomes a regular custom role, and users and teams that have it keep their access. Like any other custom role, it is editable when role exclusivity is Flexible and frozen when it is Strict. The role no longer appears in the group's Shared Roles list.

## Move users to a shared role{% #move-users-to-a-shared-role %}

Datadog does not move users from existing roles to shared roles. Assign a shared role in each member organization the same way as any other role:

- [Edit a user's roles](https://docs.datadoghq.com/account_management/users.md#edit-a-users-roles) in Datadog.
- Provision roles from your identity provider with [SCIM](https://docs.datadoghq.com/account_management/scim.md#role-provisioning-behavior).
- Map identity provider attributes to roles with [SAML group mapping](https://docs.datadoghq.com/account_management/saml/mapping.md#map-saml-attributes-to-datadog-roles).

## Resolve a role name conflict{% #resolve-a-role-name-conflict %}

You cannot convert an existing custom role into a shared role. Datadog also does not take over an existing role that has the same name as a new shared role. To replace an existing custom role with a shared role:

1. In a member organization that has the conflicting role, open the role on the Roles page and note its permissions. If the role exists in several member organizations with different permissions, decide which permissions the shared role grants.
1. In the owner organization, create a shared role with those permissions and a different name, such as `<ROLE_NAME> (Shared)`.
1. In each member organization, assign the shared role to the users and teams that have the original role.
1. In each member organization, delete the original custom role.

## Further reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Organization Groups](https://docs.datadoghq.com/account_management/organization_groups.md)
- [Role Based Access Control (RBAC)](https://docs.datadoghq.com/account_management/rbac.md)
- [SAML Group Mapping](https://docs.datadoghq.com/account_management/saml/mapping.md)
