Overview
Reaction roles let your members self-assign roles by reacting to a message. No setup beyond the initial panel -it runs automatically from there.
How it works
You create a panel message that lists roles next to emojis. When a member reacts with an emoji, the bot adds the matching role. Removing the reaction removes the role. The bot can optionally DM members when a role is added or removed.
- Up to 12 panels per community, each holding up to 30 role–emoji pairs.
- Two message types: plain content or a rich embed.
- Exclusive mode limits a panel to one role per user at a time.
Permission required
Manage Guild
f!roles command requires the Manage Guild permission. Members can react freely without any special permission.Quick start
Run the create command, write your message using {role:RoleName} placeholders, then react to the bot's copy in the order your roles appear.
f!roles createThe bot posts a setup prompt. Send a message like this:
Color Roles:
{role:Blue}
{role:Red}
{role:Purple}Then react to the bot's copy of your message with one emoji per role, in the same order. React ✅ when done.
Reaction roles
Run the command
Type f!roles create.
Write your message
Add {role:YourRole} for each role.
Bot copies it
React to the bot's copy with one emoji per role.
Assign roles
Each emoji pairs with its role.