Reaction RolesLet members self-assign roles with reactions.

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

The 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.

Fluxer
f!roles create

The bot posts a setup prompt. Send a message like this:

Your message
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

#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.

Chapters in this guide