BabelBot DocsHow BabelBot auto-translates Discord messages
Learn when BabelBot translates Discord messages automatically, when it skips, and how quotas and bridges behave.
Understanding BabelBot’s behavior helps you troubleshoot “missing” translations and control channel noise. This guide explains the full flow from message to translation.
Automatic Discord message translation pipeline
- Message arrives in a guild channel
- BabelBot checks if the channel is part of a bridge
- Pre-validation skips decide whether to continue or skip
- Server, channel, and language settings are validated
- Remaining translation quota is checked
- Translation runs for each configured target language
- Post-translation logic drops no-op outputs (e.g. source already matches target)
- Response is posted as reply or in a thread, based on your setting
- Usage is recorded only when a translation is actually sent
When BabelBot skips (and when it does not)
Messages are skipped before translation when:
- The author is a bot
- Exception: native followed announcement crossposts can be translated when the dashboard setting is enabled
- The message is not in a guild channel (e.g. DMs)
- The user opted out with
/ignore-me enable - The content is not translatable: links-only, command-like, emoji-only, short shorthand, or code blocks
Output is skipped after translation when:
- The source language already matches the target
- The model determines no translation is needed
Reply vs thread mode
| Scenario | reply mode | thread mode |
|---|---|---|
| Single target language | Translation appears as a channel reply | Translation appears in a thread |
| Multiple target languages | Multiple replies in the channel | All translations grouped in one thread |
Controlling noise
With multiple target languages, thread mode keeps channels readable. Use reply for low-volume, single-language channels.
Quota and limits
- Metered tiers: Monthly message limits apply. FREE and STARTER can add one-time top-up credits from dashboard billing.
- Top-up credits: Credits are consumed after base monthly quota, roll over, and do not expire.
- Unlimited tiers: No monthly cap. Any stored top-up credits are frozen while the server stays on ADVANCED or LIFETIME.
- What counts: Usage increments only when a translation is actually posted, not when messages are skipped.
Bridge behavior
Bridges link two channels for bidirectional translation:
- When a message is posted in a bridged channel, BabelBot infers the source language from that channel’s setting
- The translation is posted to the paired channel in its target language
- Quota and skip logic apply to bridge translations the same way as regular channel translation
Followed announcement behavior
When Followed announcements is enabled in dashboard settings:
- BabelBot can translate native Discord Following crossposts even though they are bot/webhook authored
- Detection is limited to native crosspost messages to avoid translating unrelated bot/webhook traffic
- If a followed announcement is embed-only, BabelBot translates embed description/body text
- The translated result is sent using the same reply/thread mode configured for the server
When the setting is off, these followed announcement crossposts are skipped.
Flag reaction shortcut
When someone reacts to a message with a supported flag emoji (e.g. for Japanese):
- BabelBot translates that message to the associated language
- It avoids duplicating a language already in the thread
- The result follows your reply preference (reply or thread)
- Flag translations count toward your daily usage
Summary
- “Missing” translations are usually valid skips (bots, code blocks, opt-outs, or non-translatable content).
- Reduce noise by switching to thread mode or disabling low-value channels.
- If you hit quota, buy a top-up pack or upgrade your plan, and narrow the number of active channels and languages.