BabelBotDiscord translator bot troubleshooting
Fix cases where a Discord translator bot is not working with step-by-step checks for settings, bridges, and quotas.
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:
| 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:
- Open Settings → Reply preference. Choose Reply in threads.
- Remove low-priority target languages.
- Tighten channel rules so fewer channels auto-translate.
- Remove unused bridges.
Bridge check order
- Confirm the bridge is visible in the dashboard.
- Confirm languages match how your community uses each channel.
- Confirm permissions in every linked channel.
- Test text in each direction.
- 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.
- 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
/upgradefor 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
- Open Billing & upgrades. Note if usage fails to load or looks stale.
- Send one test message in an enabled channel.
- Note whether translations pause entirely or only usage is wrong.
Expected behavior
| 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
- Tell moderators BabelBot cannot check AI quota right now.
- Avoid spamming retry tests in public channels.
- Re-check billing every few minutes.
- 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