# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalsamba.com/dashboard/adding-moderation-to-your-rooms-with-roles/create-a-custom-role.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.