Skip to main content
The Permissions page shows the bot’s current Discord permissions in your server. If any required permissions are missing, features may not work correctly. You can re-authorize the bot directly from this page to fix it.
The Permissions page requires the bot to be connected to your server. Find it in Configuration > Permissions.

How it works

The dashboard fetches the bot’s guild member data and computes its effective permissions from all assigned roles. It then compares those against the full set of permissions BrewBot needs to operate. Each permission is shown with:
  • A green check if granted
  • A red X if missing, with a description of which features are affected

Required permissions

BrewBot requests these 17 permissions:
PermissionUsed for
Kick MembersAutoMod role enforcement, captcha timeout kicks
Ban MembersCaptcha verification temp bans
Manage ChannelsChannel manager, creating channels from dashboard
Add ReactionsReaction roles
View Audit LogMod logs — identifying who performed moderation actions
View ChannelRequired for all features
Send MessagesWelcome messages, mod logs, alerts, captcha verification
Manage MessagesAutoMod link blocking, message deletion
Embed LinksAll embed-based features (mod logs, alerts, etc.)
Attach FilesFile uploads in bot messages
Read Message HistoryAI chat context, message snapshots for mod logs
Use External EmojisReaction roles with external server emojis
Mention EveryoneAnnouncement pings in alerts
ConnectVoice features, text-to-speech
SpeakVoice features, text-to-speech
Manage RolesReaction roles, captcha verification, leveling rewards
Moderate MembersTimeout/mute capabilities

Re-authorizing the bot

If permissions are missing, click Re-authorize Bot on the Permissions page. This opens Discord’s authorization popup where you can grant the updated permissions without removing the bot from your server.
1

Open Permissions

Go to Configuration > Permissions in the dashboard.
2

Review missing permissions

Any permissions with a red X are missing. The status card on the right shows the total count.
3

Click Re-authorize Bot

This opens Discord’s OAuth popup. Approve the permissions and close the popup.
4

Verify

The page refreshes automatically after the popup closes. All permissions should now show green checks.
Re-authorizing does not remove the bot, reset settings, or affect your server in any way. It only updates the bot’s permission set.

Role position

The Permissions page also shows the bot’s role position in your server’s role hierarchy. The bot can only manage roles that are below its own role. If role-based features (reaction roles, captcha verification, leveling rewards) aren’t working:
  1. Open Server Settings > Roles in Discord
  2. Drag the bot’s role higher in the list
  3. Make sure it’s above any roles it needs to assign

FAQ

Permissions can change if a server admin modifies the bot’s role permissions, or if the bot was originally invited with an older permission set. Re-authorizing updates the bot’s role to include all current required permissions.
No. Re-authorizing only updates the bot’s Discord role permissions. All dashboard settings, reaction roles, mod logs, and other configurations remain unchanged.
If the bot’s role has the Administrator permission, all other permissions are automatically granted. The page will show “ADMINISTRATOR” and all permissions will be green.
BrewBot only requests permissions it actively uses. Removing any of them may break specific features. The permission descriptions explain what each one is used for.