> 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/translation-by-flag.md).

# Translation by Flag

React to a message with a flag and get its translation.

React to any message with a flag emoji and iTranslator replies with the translation in the languages of that country. It is the fastest way for a member to understand a message, and nothing has to be configured per channel.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-d6da6996fa3280a6f8fe966aaebf0162e6fc679e%2Fflagreaction1.gif?alt=media" alt="A member reacts with a flag and iTranslator replies with the translation"><figcaption></figcaption></figure>

The flags of every language are in the [Languages List](/fundamentals/languages-list.md).

## Enable it

{% tabs %}
{% tab title="Dashboard" %}
Open your server in the [dashboard](/fundamentals/dashboard.md), go to **Translations → Flag-Reaction** and turn on **Enable Flag-Reaction**. Every option described on this page is a card of that same page.

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-3fcc094d9fa0f07c1d1f970ed6e568d2ad1f8f0d%2Fdashboard-flag.png?alt=media" alt="The Flag-Reaction page of the dashboard"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Command" %}
Run `/flagreaction toggle`. The same command turns the feature off again, so check that it is enabled.
{% endtab %}
{% endtabs %}

## Keep the server clean <a href="#keep-the-server-clean" id="keep-the-server-clean"></a>

You can make the translations disappear after a while. Set a delay in seconds (up to 300): once it has passed, the translated message is deleted automatically. Set it to `0` to disable the option.

{% tabs %}
{% tab title="Dashboard" %}
On the **Flag-Reaction** page, set **Time (seconds)** in the **Auto-Disappear** card.
{% endtab %}

{% tab title="Command" %}
Run `/flagreaction config auto-disappear (delay)`.
{% endtab %}
{% endtabs %}

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-e8c6ebb4926316fd7875b160ff8033a7aafc78e4%2Fflagreaction3.gif?alt=media" alt="A flag translation that disappears after a few seconds"><figcaption></figcaption></figure>

## Send the translation in private messages <a href="#sending-translation-in-private-messages-premium-only" id="sending-translation-in-private-messages-premium-only"></a>

{% hint style="info" %}
This option requires [**Premium**](/overview/premium.md).
{% endhint %}

The translation is sent privately to the member who reacted, so nobody else is disturbed.

{% tabs %}
{% tab title="Dashboard" %}
On the **Flag-Reaction** page, turn on **Send in PM**.
{% endtab %}

{% tab title="Command" %}
Run `/flagreaction config send-in-pm`.
{% endtab %}
{% endtabs %}

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-5cfb1a9f90609f77627b1605c156a1c4bced5dae%2Fflagreaction4.gif?alt=media" alt="A flag translation received in a private message"><figcaption></figcaption></figure>

{% hint style="warning" %}
Sending in private messages is not compatible with the Webhook style. Choose the Embed or Text style.
{% endhint %}

## Send the translation in a thread <a href="#send-in-thread" id="send-in-thread"></a>

{% hint style="info" %}
This option requires [**Premium**](/overview/premium.md).
{% endhint %}

The translations are posted in a thread attached to the message instead of the channel itself. It is another way to keep your channels clean.

{% tabs %}
{% tab title="Dashboard" %}
On the **Flag-Reaction** page, turn on **Send in Thread**.
{% endtab %}

{% tab title="Command" %}
Run `/flagreaction config send-in-thread`.
{% endtab %}
{% endtabs %}

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-d812b26fa0b080ace59d3a6155ce5dcf840089f9%2Fflagreaction5.gif?alt=media" alt="A flag translation posted in a thread"><figcaption></figcaption></figure>

## Configure the style <a href="#configure-the-style" id="configure-the-style"></a>

Three styles are available:

* **Embed** (default)
* **Text**
* **Webhook**

{% tabs %}
{% tab title="Dashboard" %}
On the **Flag-Reaction** page, choose the **Format** in the **Translation Style** card.
{% endtab %}

{% tab title="Command" %}
Run `/flagreaction config style`.
{% endtab %}
{% endtabs %}

<figure><img src="https://3955709218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuW8Vjy8RHWcWMwcAWdcy%2Fuploads%2Fgit-blob-f52efac9f15be11bd147f1508fc73408f98e7b21%2Fflagreaction2.gif?alt=media" alt="The same flag translation in the different styles"><figcaption></figcaption></figure>

## Good to know

* The message must be recent: iTranslator does not translate messages that are too old.
* A flag translates into every language of the corresponding country.
* [Translate-Ban](/amazing-features/translate-ban-role-and-user.md) prevents specific members or roles from using flag reactions.

{% hint style="danger" %}
**Disable it in a channel:** you may not want flag translations in some channels, such as announcements. Add `no-translate` to the [channel topic](/fundamentals/ignore-content-and-channels-in-translations/ignore-channel-to-translate.md), or remove the permission of iTranslator to send messages in that channel.
{% endhint %}