# Role Translation

{% hint style="danger" %}
iTranslator NEED permissions `VIEW_CHANNEL`, `SEND_MESSAGE`, `MANAGE_WEBHOOKS`, `MANAGE_MESSAGES`, `MESSAGE_EMBED_LINKS` in **every channel** it work (sources & targets) if you want to make it work properly. Please, be sure to have these permissions **enabled** before reporting an issue!
{% endhint %}

> This feature is very similar to [Auto-Translate](https://docs.itranslator.app/amazing-features/automatic-translation) but is simpler because it is simply linked to a role on your server and not channels. The concept is simple: all users who have the role in question will have their messages translated as soon as they speak on your server in the chosen language.

## 1. Create a Role-Translation Configuration

To get started, you'll need to create your configuration using the `/translaterole create` command like this:

<figure><img src="https://840554241-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwtZ7bWYVAuVnh9llGL79%2Fuploads%2FL2TFiLOLQZJv2sQtcSO2%2Fimage.png?alt=media&#x26;token=25caaef9-73cd-4a49-b891-ac0cc4f26853" alt=""><figcaption><p>iTranslator - Translate-Role create</p></figcaption></figure>

#### Arguments Details

<table><thead><tr><th width="179">Name</th><th width="411.3333333333333">Explanation</th><th>Optional</th></tr></thead><tbody><tr><td>@Role</td><td>The role that will be linked to the translations.</td><td>NO</td></tr><tr><td>language</td><td>Language in which messages from members with the linked role will be automatically translated.</td><td>NO</td></tr></tbody></table>

## 2. List all your configurations

In the next few pages of the documentation for this feature, you can modify a number of parameters. If you want to have an overview of all the configurations you have created, you can use the `/translaterole list` command.

{% hint style="info" %}
We are constantly improving this system to increase simplicity and performance. Feel free to send us your suggestions on our [Discord Server](https://discord.itranslator.app).
{% endhint %}

{% hint style="danger" %}
iTranslator NEED permissions `VIEW_CHANNEL`, `SEND_MESSAGE`, `MANAGE_WEBHOOKS, MANAGE_MESSAGES`, `MESSAGE_EMBED_LINKS` in **every channel** it work (sources & targets) if you want to make it work properly. Please, be sure to have these permissions **enabled** before reporting an issue!
{% 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.itranslator.app/amazing-features/role-translation.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.