# Channel Translation
{% hint style="info" %}
If you need help at any point join our [**Discord Server**](https://discord.gg/mgNR64R) and someone will help you.
{% endhint %}
{% hint style="danger" %}
We do suggest you to use [Group Translations](/ritabot-docs/usage-commands-and-settings/translation/group-translations.md) instead of Channel Translation as it's easier to create and to maintain
{% endhint %}
*Automatically translates any new messages in the current channel and forwards them to the target channel. Admins/mods can set forwarding to the same channel(not recommended) or other channels(recommended).*
*Please note that when you setup an auto command the target channel will not send back to main channel unless you tell it to*
## Slash Commands (easier)
* `/auto` to create a task to translate from one channel to the other, from one lang to a target language
* `/stop task` to delete an existing tasks (they will be listed, just pickup the one you want to remove)
* `/stop server` will remove all tasks of the server : be carefull and check that it's really what you want
* `/stop channel` will stop all tasks for the channel choosen
## Legacy commands (complex)
**`!tr channel from [lang] to [lang] for #[dest]`**
**`!tr auto to [lang] for #[same channel dest]`**
**`!tr channel from [lang] to [lang] for #[dest] filter @[role]`**
### Parameters
* for **`[dest]`** The target channel you want the translation of the from **`[lang]`** to go to.
* to **`[lang]`** *(optional)*\
The language to translate to, defaults to server default language if none provided.
* from **`[lang]`**\
The language to translate from.
* filter \[role] can be used to restriction translation to a specific role.
* NOTE : Auto is for a single ( same channel ) translations, as photos, and Gifs, will not be duplicated or sent.
## Examples
Using full language names
**`!tr channel from english to spanish for #target-channel`**
**`!tr auto to spanish for #current-channel`**
Using language short codes
**`!tr channel from en to es for #target-channel`**
**`!tr auto to es for #current-channel`**
Using Auto detection
**`!tr auto to ru for #current-channel`**
### Server Admins/Mods
Send translations to same channel ( Not recommended for more than 3 languages )
**`!tr channel from english to spanish for #current-channel`**
**`!tr auto to spanish for #current-channel`**
Send translations to another channel in server ( Recommended )
**`!tr channel from english to spanish for #target-channel`**
**`!tr channel from english to spanish for #target-channel`**
**`!tr auto to spanish for #current-channel`**
Send translations to multiple channels in the server at once
**`!tr channel from english to spanish for #target-channel-es1, #target-channel-es2, #target-channel-es3, #target-channel-es4`**
**`!tr channel from english to spanish for #target-channel-es1, #target-channel-es2, #target-channel-es3, #target-channel-es4`**
## Stopping Translations
To stop an automatic translation task, simply go the origin channel of the task and use the stop command:
**`!tr stop`**
**`!tr stop task [id!tr stop for [me]`**
**`!tr for [@user]`**
**`!tr stop for [#channel]`**
**`!tr stop for [all]`**
**`!tr stop for [server]`**
### Parameters
* **\[id],** ID number for the task you want to stop, run !tr tasks to get id.
* for **\[me]** - Stops translations via DM to yourself.
* for **`[@user]`** - Stops the task for user.
* for **`[channel]`** - Stops the task from the channel posted to the channel destination.
* for **\[all]** - Stops all translations in the channel its posted in.
* for **\[server]** - Stops all translations being done in your server.
## Admins/Mods
Stop all automatic translations
**`!tr stop task [ID]`**
Stop a single task by running !tr task, and taking note of the ID of the item to remove.
**`!tr stop for [@UserID]`**
Stop a translation being sent to a user.
**`!tr stop for #target-channel`**
Stop all automatic translations for specific channel in server
**`!tr stop for all`**
Stop all automatic translations for the channel.
**`!tr stop for server`**
Stop all tasks in the server.
*Help command for stop: **`!translate help stop`***
## Notes
*Help command for automatic translation: **`!translate help auto`**.*
* Values wrapped in brackets **`[ ]`** are solely for illustrative purposes to demonstrate the use of the command. Brackets are not in any command.
**`[lang]`** values can be language names in English, native language names or ISO 639-1 codes. For example, **`german`** **`de`** and **`deutsch`** will all work the same.
* Messages by all bots are currently ignored to avoid loops, but we are working on different bot modes to enable bot translation.
* Any message that begins with **`!tr`** or **`!translate`** will be determined to be a bot command and thus shall not be allowed to be translated.
{% hint style="info" %}
**Important Note**
*The bot’s default prefix is !tr (or !translate) - All commands must start with this prefix for the bot to process them. Bot must have proper permissions in all relevant channels for full functionality (**read**, **write**, **react**, **mention**, **attachments**, **embed**).*
{% 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.ritabot.gg/ritabot-docs/usage-commands-and-settings/translation/chan.md?ask=
```
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.