> For the complete documentation index, see [llms.txt](https://docs.itranslator.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.itranslator.app/amazing-features/role-translation.md).

# Role Translation

Translate everything written by the members of a role, wherever they talk.

Role Translation works like [Automatic-Translation](/amazing-features/automatic-translation.md), but it is linked to a **role** instead of channels. Every member who has the role gets their messages translated into the languages you choose, in any channel of the server.

It is a simple way to help international staff, partners or guests take part in the conversation without setting up channel after channel.

## How it works

* A configuration links **one role** to one or several **target languages**.
* When a member with that role writes a message, the translation is posted in the same channel.
* A server can have up to 3 configurations on the free plan, and an unlimited number with [Premium](/overview/premium.md).

<table><thead><tr><th width="330"></th><th>Free</th><th>Premium &#x26; Pro</th></tr></thead><tbody><tr><td>Configurations</td><td>3</td><td>Unlimited</td></tr><tr><td>Target languages per configuration</td><td>1</td><td>Unlimited</td></tr><tr><td><a href="/amazing-features/role-translation/configure-style-and-format.md#format">Custom message format</a></td><td>No</td><td>Yes</td></tr></tbody></table>

## Create a configuration

{% tabs %}
{% tab title="Dashboard" %}
{% stepper %}
{% step %}

### Open the Role-Translation page

Open your server in the [dashboard](/fundamentals/dashboard.md) and go to **Translations → Role-Translation**.
{% endstep %}

{% step %}

### Add a configuration

Click **Add a configuration**, select the role and choose the target languages. Every other field is optional and explained in [Configure options](/amazing-features/role-translation/configure-options.md).

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-b4e57312dd953a76fcc86b585e00543594104481%2Fdashboard-roletranslate-modal.png?alt=media" alt="The Add a configuration form of the Role-Translation page" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Save

Click **Save**, then give the role to the members who need it.
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Command" %}
Run `/translaterole create`:

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-347cdcb806676c8f5cac78fbacef61a53a9ac863%2Fimage%20(2)%20(1).png?alt=media" alt="The /translaterole create command with its arguments"><figcaption></figcaption></figure>

<table><thead><tr><th width="179">Argument</th><th width="411">Explanation</th><th>Optional</th></tr></thead><tbody><tr><td><code>role</code></td><td>The role linked to the translations.</td><td>No</td></tr><tr><td><code>language</code></td><td>The language into which the messages of the members with that role are translated.</td><td>No</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

## Manage your configurations

{% tabs %}
{% tab title="Dashboard" %}
The **Role-Translation** page lists every configuration with its role, languages and style. Use **Edit** to change one and **Delete** to remove it.
{% endtab %}

{% tab title="Commands" %}

| Command                     | What it does                                  |
| --------------------------- | --------------------------------------------- |
| `/translaterole list`       | Lists all your configurations.                |
| `/translaterole display`    | Shows every setting of one configuration.     |
| `/translaterole config ...` | Changes one setting of a configuration.       |
| `/translaterole delete`     | Deletes a configuration.                      |
| `/translaterole delete-all` | Deletes all the configurations of the server. |
| `/translaterole help`       | Displays a summary of the feature.            |
| {% endtab %}                |                                               |
| {% endtabs %}               |                                               |

## Good to know

* To stop Role Translation in a specific channel, add `no-roletranslate` to its topic. See [Ignore channel to Role-Translate specifically](/fundamentals/ignore-content-and-channels-in-translations/ignore-channel-to-role-translate-specifically.md).
* iTranslator needs the same permissions as for Automatic-Translation in the channels where these members talk. See [Required permissions](/amazing-features/automatic-translation.md#required-permissions).

## Go further

{% content-ref url="/pages/2j1SbG9oVMeH0wfXiM12" %}
[Configure style & format](/amazing-features/role-translation/configure-style-and-format.md)
{% endcontent-ref %}

{% content-ref url="/pages/TmZuYFOGAO9KcqNQAaSS" %}
[Configure languages](/amazing-features/role-translation/configure-languages.md)
{% endcontent-ref %}

{% content-ref url="/pages/Ec8vVSUQMm0R3Gx6bGdb" %}
[Configure options](/amazing-features/role-translation/configure-options.md)
{% endcontent-ref %}

{% hint style="info" %}
We keep improving this system. Send us your suggestions on our [Discord Server](https://discord.itranslator.app).
{% endhint %}