Skip to main content
This is a premium feature. Upgrade your plan to access it.
The custom bot feature lets you replace the default BrewBot with your own Discord bot application. Your bot gets its own name, avatar, and status — while still being managed through the BrewBot Dashboard.

​
Prerequisites

Before starting, make sure you have:
  • An active BrewBot premium subscription
  • A Discord account with an authenticator app enabled (recommended)
  • Your browser’s pop-up blocker temporarily disabled

​
Create a Discord application

1

Open the Developer Portal

Go to discord.com/developers/applications and sign in with your Discord account.
2

Create a new application

Click New Application, enter a name, accept Discord’s policies, and click Create.
You can change the name later, but bot name changes have a 7-day cooldown enforced by Discord.

​
Enable required intents

In your new application, go to the Bot tab and scroll down to Privileged Gateway Intents. Enable all three:
  • Presence Intent
  • Server Members Intent
  • Message Content Intent
Do not enable “Requires OAuth2 Code Grant” — this will break the connection.

​
Add the redirect URI

1

Open the OAuth2 tab

In your application, go to the OAuth2 tab.
2

Add the redirect URL

Under Redirects, click Add Redirect and enter exactly:
Click outside the field, then click Save Changes.

​
Copy your tokens

You need two values from the Developer Portal.

​
Client secret

  1. Go to the OAuth2 tab
  2. Click Reset Secret and confirm
  3. Copy the client secret

​
Bot token

  1. Go to the Bot tab
  2. Click Reset Token and confirm
  3. Copy the bot token
Never share your bot token or client secret. If either is compromised, reset it immediately in the Developer Portal.

​
Connect in the dashboard

1

Open bot personalizer

Go to the BrewBot Dashboard, select your server, and open Bot Personalizer.
2

Start custom bot setup

Click Use Custom Bot (or Set up Custom Bot if you’re already using the default BrewBot).
3

Confirm the prerequisites

Check all three boxes to confirm you have:
  • Required Intents enabled
  • OAuth2 Code Grant disabled
  • Redirect URI added
4

Enter your tokens

Paste your Client Secret and Bot Token into the form fields.
5

Enable bot personalizer

Click Enable Bot Personalizer. The dashboard validates your token against Discord before saving.
6

Authorize command permissions

A Discord pop-up opens asking you to authorize the bot for your server. This grants the same permissions as the default BrewBot:
  • Manage Channels — dashboard channel management
  • Add Reactions — reaction roles
  • View Channel — access channels across all features
  • Send Messages — nearly every feature
  • Manage Messages — custom commands, alert auto-delete, reaction role embeds
  • Embed Links — audit log, welcome messages, alerts, leveling
  • Attach Files — AI voice messages, image generation
  • Read Message History — reaction roles, audit log
  • Use External Emojis — embeds with external emojis
  • Mention Everyone — alert default messages
  • Connect — AI voice channel join
  • Speak — AI voice channel playback
  • Manage Roles — reaction roles, leveling role rewards, dashboard role management
Click Authorize to complete the setup.
Re-authorizing the bot updates its server-wide permissions, but it does not override private channel or category denies. If your custom bot needs to post in a locked channel, allow the bot role in that channel or in its parent category.For features like reaction roles, welcome messages, and alerts, the target channel usually needs View Channel, Send Messages, Add Reactions, and Read Message History for the bot role.
If BrewBot updates its required permissions, you can re-authorize at any time from the Bot Permissions card on the Bot Personalizer page. This updates the bot’s permissions without removing it from your server.

​
After setup

Once connected, the Bot Personalizer page shows the Custom Bot Appearance card where you can configure: A live preview shows how your bot will appear in Discord.
Your custom bot fully replaces BrewBot in your server. All dashboard features — reaction roles, welcome messages, commands — work through your custom bot. You can optionally remove the default BrewBot from your server.

​
Move the bot role

After setup, go to Server Settings > Roles in Discord and drag your custom bot’s role above the roles it needs to manage. The bot can only assign roles that are below its own role in the hierarchy.

​
Disconnect the custom bot

To switch back to the default BrewBot, open Bot Personalizer and click Disable Custom Bot. This clears your stored tokens and reverts all features to the default BrewBot.