> For the complete documentation index, see [llms.txt](https://docs.digitalsamba.com/dashboard/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalsamba.com/dashboard/adding-moderation-to-your-rooms-with-roles/create-a-custom-role.md).

# Create a custom role

You may create a new custom role from scratch or by editing an existing [preset role](/dashboard/adding-moderation-to-your-rooms-with-roles.md).

To create a new role from scratch, go to to the [Roles section](https://dashboard.digitalsamba.com/rooms) of the dashboard and click on the 'Create a role' button. You may also create a new role using the [REST API](https://docs.digitalsamba.com/developer-api/#roles-POSTapi-v1-roles)

<figure><img src="/files/aRBqrjGJJYXbxyK2pcTR" alt=""><figcaption></figcaption></figure>

Configure your custom role with a unique role identifier, a role display name and a set of permissions:

* **Role identifier**\
  This identifier is needed to recognise the role and is needed to be unique across all roles in your team. You will use it inside the JWT token to assign a role to each participant.
* **Role display name**\
  This is how the role will be displayed in the room. Note that preset display names will be translated to our supported languages, however any custom values will remain monolingual.
* **Role description**\
  Optionally use this field to add your own notes.
* **Role permissions**\
  Read on to learn how to set [permissions](/dashboard/adding-moderation-to-your-rooms-with-roles/permissions.md) for your roles.

{% hint style="warning" %}
When creating a new role, you will need to manually re-configure your existing roles' [role-sensitive permissions](/dashboard/adding-moderation-to-your-rooms-with-roles/permissions.md), to ensure the new role is deliberately included when needed.
{% endhint %}
