Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.brewbot.dev/llms.txt

Use this file to discover all available pages before exploring further.

Reaction roles let members pick their own roles by reacting to a message with an emoji. When a member adds a reaction, the bot assigns the corresponding role. When they remove the reaction, the bot removes the role.

​
Set up reaction roles

1

Open the dashboard

Go to the BrewBot Dashboard and select your server.
2

Navigate to Reaction Roles

Open the Reaction Roles page from the sidebar.
3

Create a new reaction role message

Click Create to start a new reaction role message. Give it a title and optional description that tells members what roles are available.
4

Add emoji-to-role mappings

For each role you want to offer, select an emoji and the role it should assign. You can add as many mappings as you need.
5

Set the target channel

Choose the channel where the bot should post the reaction role message. The bot sends the message and adds the configured emoji reactions automatically.

​
Permissions

The bot needs the Manage Roles permission to assign and remove roles. Its role in the server role hierarchy must be positioned above any roles it assigns. If the bot’s role is lower, it cannot grant those roles.
The bot also needs access to the channel where you post the reaction role message. If that channel is private, locked, or inherits restrictive category overwrites, allow the bot role in that channel or category before you publish.For reaction roles, the safest channel-level permissions are View Channel, Send Messages, Add Reactions, and Read Message History for the bot role.