> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brewbot.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Find the fix for common BrewBot problems, organized by symptom and by feature.

Start with the symptom closest to yours. Each link opens the troubleshooting table on that feature's page.

## Common problems

| Symptom | Where to look |
| - | - |
| BrewBot doesn't appear in your server, or the dashboard says permissions are missing | [Add BrewBot](https://docs.brewbot.gg/getting-started/add-bot.md#troubleshooting) and [Permissions](https://docs.brewbot.gg/features/permissions.md#faq) |
| Your custom bot is offline, can't read messages, or can't join voice | [Custom bot setup](https://docs.brewbot.gg/features/custom-bot.md#troubleshooting) |
| A feature is locked or missing from the sidebar | [Pricing and billing](https://docs.brewbot.gg/getting-started/billing.md) for premium features, [Teams](https://docs.brewbot.gg/getting-started/teams.md#feature-permissions) for access |
| TikTok chat isn't being read aloud | [TikTok TTS](https://docs.brewbot.gg/features/tts.md#troubleshooting) |
| Twitch chat isn't being read aloud | [Twitch TTS](https://docs.brewbot.gg/features/twitch-tts.md#troubleshooting) |
| An OBS browser source is blank or silent | [Overlays](https://docs.brewbot.gg/features/overlays.md#troubleshooting) |
| One kind of sound is too loud or too quiet | [Volume](https://docs.brewbot.gg/features/volume.md#troubleshooting) |
| A gift or sticker doesn't play a sound | [Gift Sounds](https://docs.brewbot.gg/features/gift-sounds.md#troubleshooting) and [Sticker Sounds](https://docs.brewbot.gg/features/sticker-sounds.md#troubleshooting) |
| A live, video, or stream alert didn't post, or posted late | [Alerts](https://docs.brewbot.gg/features/social-alerts.md#troubleshooting) |
| The chat monitor says reconnecting, or Battle mode won't open | [TikTok Chat Monitor](https://docs.brewbot.gg/features/live-monitor.md#troubleshooting) |
| The Speed Grid says updates are delayed, or a move is rejected | [Speed Tracker](https://docs.brewbot.gg/features/speed-tracker.md#troubleshooting) |
| BrewBot won't join voice for a horoscope reading | [Horoscopes](https://docs.brewbot.gg/features/horoscopes.md#troubleshooting) |
| A meeting summary didn't post | [Meeting notes](https://docs.brewbot.gg/features/meetings.md#if-the-summary-cant-be-posted) |
| A poll didn't post | [Polls](https://docs.brewbot.gg/features/polls.md#faq) |
| New members can't verify | [Captcha Verification](https://docs.brewbot.gg/features/captcha-verification.md#faq) |

## Before you ask for help

1. Confirm the server has premium if the feature needs it. Open **Configuration > Billing** to check.
2. Open **Configuration > Permissions** and fix anything BrewBot reports as missing.
3. Check that BrewBot can see and post in the channel you selected. Channel permission overrides can block BrewBot even when its role allows the action.
4. For stream audio, reload the OBS browser source after copying a fresh overlay URL.

Still stuck? Ask in the [BrewBot support server](https://discord.gg/WbMUYr7DCg). Include the feature name, what you expected, and what happened instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.