# Custom Roles

Custom roles are based on permissions that compose the predefined roles. Create custom roles to grant limited access to product resources, organizations, or project entities. Custom roles are defined at the root organization level and are available for all standard and reseller organizations and projects.

![](https://docs.equinix.com/assets/images/iam-custom-role-d0054e19e3061f8d96b9b68f4280a0db.png)

## Creating Custom Roles[​](#creating-custom-roles "Direct link to Creating Custom Roles")

To create a custom role:

1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as an IAM Admin user.

2. Click *Roles*, then click **Create Custom Role**.

3. Enter the *Role Name* and a *Description*.

   ![](https://docs.equinix.com/assets/images/iam-custom-role-create-ec876f15f7e599fa0686517f5998087e.png)

4. Assign permissions to the custom role.

   > **Info**
   >
   > You can't edit the list of permissions once you create the custom role.

   1. In the *Role Permissions* section, click **Add Permission**.
   2. From the *Role* drop-down menu, select roles from which you want to include permissions in your custom role.
   3. Select permissions which you want to include in your custom role.
   4. Click **Save**.

5. Click **Create Role**.

## Cloning Custom Roles[​](#cloning-custom-roles "Direct link to Cloning Custom Roles")

To clone a custom role:

1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as an IAM Admin user.

2. Click *Roles*.

3. Locate the custom role you want to clone, then hover over ![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABcAAAARCAYAAAA2cze9AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAADJSURBVDhPY/wPBAw0AkxQmiZg1HCsYOgajpoU/91jWNu7k+HINwYGFjFjhpJMMwZxkPiP2wwrJ+9hOAEU55QwZshPh4p/uc4wf+oBhks/GBh41RwYKiM1GThB4lCA6vIXTxluAw0AgT+vbjNcegZhM1y7DjYYBL6/eMLw9BeEzXALqAZoMAh8BrJvQ5hwgGq4hDSDKheEySKmyqAnBWEzaGkyWEDFOSVkGKTZIGwGNaAaDgiTF8hWhTDhYDSHYgWjhmMFNDScgQEAmOA7FK1K2toAAAAASUVORK5CYIL4vg/TNGnzxC7JLsFKBkEA27Zp85748fMS5XiJcrxEOT7AD4xLTOszz0+yAAAAAElFTkSuQmCC) and select Clone Role.

4. Enter the **Role Name** and the **Description**.

5. Add or remove permissions.

6. Click **Clone Role**.

> **Warning**
>
> If another role with identical permissions already exists, the following warning will be displayed. Instead of creating another role with identical permissions, consider re-using roles.

![](data:image/png;base64,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)

## Deleting Custom Roles[​](#deleting-custom-roles "Direct link to Deleting Custom Roles")

> **Note**
>
> Custom roles are deleted only at the selected hierarchy level so they remain available at other levels in the hierarchy.

To delete a custom role:

1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as an IAM Admin user.

2. Click *Roles*.

3. Locate the custom role you want to delete and from the options menu, select *Delete Custom Role*.

   > **Warning**
   >
   > If there are existing users assigned to the custom role, a side-menu will prompt you to reassign a different role to the users. This is to ensure that users are not assigned to non-existent roles. You also have the option to change the assignment to **No Role**.

   ![](https://docs.equinix.com/assets/images/iam-custom-role-delete-72e707ed69c7f4de323b08a9503bf065.png)

4. You will be asked to confirm *Custom Role Deletion*. Click **Delete Role**.