Discord translator bot troubleshooting

Use this page when a translation is missing or looks wrong. Work from the problem to the checks, then apply the fix. For why BabelBot skips some messages on purpose, read How BabelBot Works.

Quick configuration check

Before you dig deeper, confirm these items in the dashboard:

Quick configuration checks before troubleshooting translations

Check	Where
Translation enabled	Overview
At least one target language	Settings → Target languages
Test channel not excluded	Settings → Channel rules (verify with a test message)
AI quota remaining	Billing & upgrades
Reply mode matches expectation	Settings → Reply preference
Voice chat enabled (if testing /voice)	Settings → Voice chat translation (Ultra or Founder Access)

Run /help in Discord for admin command reminders.

Issue catalog

Reduce noisy output

Too many replies or threads? Try these steps:

1. Open Settings → Reply preference. Choose Reply in threads.
2. Remove low-priority target languages.
3. Tighten channel rules so fewer channels auto-translate.
4. Remove unused bridges.

Bridge check order

1. Confirm the bridge is visible in the dashboard.
2. Confirm languages match how your community uses each channel.
3. Confirm permissions in every linked channel.
4. Test text in each direction.
5. Test an attachment-only message in each direction. Images and supported videos should use Discord's normal preview. Spoilered media should stay hidden until opened. Other files should arrive as labeled original-file cards. Neither requires Media translation.
6. Check Overview activity chart for bridge-sourced translation usage.

Quota reached

When AI quota for the period is exhausted:

• Open Dashboard → Billing & upgrades to see usage.
• Run /upgrade for a billing link.
• Plain text in target languages without the AI only label may still translate with BabelBot's in-house translator on Free, Pro, and Ultra.
• Translating images and using flag or context-menu flows still need AI. Bridge attachment mirroring does not.

To reduce usage: use fewer languages, fewer active channels, disable flag reactions, or upgrade the plan.

When usage will not load

Use this section when usage will not load or in-channel warnings mention quota checks.

Identify

1. Open Billing & upgrades. Note if usage fails to load or looks stale.
2. Send one test message in an enabled channel.
3. Note whether translations pause entirely or only usage is wrong.

Expected behavior

Expected translation behavior during a quota service outage by tier

Tier type	Translation during outage
Free, Pro, Ultra	May pause while BabelBot cannot check remaining AI quota
Legacy Ultra, Founder Access	May continue; usage numbers can lag

What to do

1. Tell moderators BabelBot cannot check AI quota right now.
2. Avoid spamming retry tests in public channels.
3. Re-check billing every few minutes.
4. After recovery, send one test message to confirm normal flow.

Contact support

Contact support with server ID, outage start time, and a billing page screenshot if the problem lasts more than a short period.

Contact support

Reach out when:

• Settings match these docs but behavior does not
• Issues are inconsistent across channels with the same rules
• Dashboard or checkout fails repeatedly

Include: server ID, channel ID (if relevant), message ID (if relevant), time range, and a billing screenshot if the issue is quota-related.

Support: discord.gg/gjKmEnvkxx