Docs/Bot/Reaction Roles
Engagement

Reaction Roles

Let members self-assign roles by clicking reactions or buttons. Perfect for notification preferences, color roles, and interest groups.

How It Works

Create a message with emojis or buttons. When users click/react, they get the associated role. Click again to remove it. Simple self-service role assignment.

Click

React or press button

Get Role

Instant assignment

Done

Click again to remove

Reaction Role Types

Emoji Reactions

Classic reaction-based role assignment. Users react with an emoji to get the role.

  • • Standard Discord emojis
  • • Custom server emojis
  • • Multiple roles per message

Button Roles

Modern button interface. Cleaner look, easier to use on mobile.

  • • Custom button colors
  • • Button labels with emojis
  • • Up to 25 buttons per message

Dropdown Menu

Compact dropdown for many options. Great for long lists.

  • • Up to 25 options
  • • Multi-select support
  • • Description per option

Color Roles

Pre-configured for color selection. Users pick their display color.

  • • Visual color buttons
  • • Only one color at a time
  • • Easy to set up

Assignment Modes

Normal (Default)

Users can have multiple roles from the same panel. Click to add, click again to remove.

Unique

Users can only have ONE role from the panel. Selecting a new one removes the old one. Perfect for color roles.

Verify

One-time role assignment. Can't be removed by clicking again. Good for verification/rules acceptance.

Limit

Set a maximum number of roles a user can select from the panel (e.g., pick up to 3).

Common Use Cases

Notification Roles

@Announcements, @Events, @Giveaways - let users opt-in to pings

Interest Groups

Gaming, Art, Music, Crypto - categorize members by interests

Pronouns

He/Him, She/Her, They/Them - identity roles

Region/Timezone

NA, EU, ASIA - coordinate events and matches

Quick Setup

1

Open Dashboard

Go to Dashboard → Reaction Roles

2

Create New Panel

Choose type (buttons, reactions, or dropdown)

3

Design Embed

Customize the message that will contain the roles

4

Add Roles

Map emojis/buttons to roles, set mode, and send to channel