---
title: "Create a Custom Role"
description: "How to define a custom role and choose its permissions."
canonical: "https://docs.cm.com/governance/guides/customers/create-a-custom-role"
---

# Create a Custom Role

> How to define a custom role and choose its permissions.

Source: https://docs.cm.com/governance/guides/customers/create-a-custom-role

A custom role is a role you build for your organization from existing permissions. Use it when the ready-made roles give too much or too little access.

You create custom roles in the **Custom roles** section of the Governance portal. You need the Governance **Editor** permission on the organization.

## Steps

1. Open **Custom roles** and create a new role.
2. Enter a **name**.
3. Choose the **permissions** the role should include.
4. Save.

## Rules

- The name must be unique in your organization.
- Every permission you choose must exist. You can only pick permissions that applications have defined.
- The organization must be active.

## Use the role

Once saved, you can [assign the role](https://docs.cm.com/governance/guides/customers/assign-a-role) to users and teams like any other role.

## Good to know

- Adding or removing permissions later updates the role as a whole.
- Creating and changing custom roles is recorded in the [change log](https://docs.cm.com/governance/guides/customers/view-logs).

## Related

- [Custom roles](https://docs.cm.com/governance/guides/core-concepts/custom-roles)
- [Roles](https://docs.cm.com/governance/guides/core-concepts/roles)
- [Permissions](https://docs.cm.com/governance/guides/core-concepts/permissions)