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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.itranslator.app/amazing-features/translation-by-flag.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.