Reaction Roles

Let members assign themselves roles using buttons, dropdowns, or reactions. Perfect for color roles, notification preferences, and more.

Overview

Reaction Roles let members self-assign roles by interacting with a message. Natsumi supports modern button/dropdown menus as well as classic emoji reactions.

Buttons

• Clean, modern look
• Custom colors
• Up to 25 roles per message
• Instant response

Dropdown

• Select multiple at once
• Compact design
• Up to 25 options
• Min/max selections

Reactions

• Classic approach
• Works with any emoji
• No limit on reactions
• Visual feedback

Creating Reaction Role Panels

Step 1: Create the Panel

Create Panel Command

/reactionrole create type:buttons title:"Get Your Roles!"

Step 2: Add Roles

Add roles to your panel using the add command:

Add Role to Panel

/reactionrole add-option message-id:1234567890 role:@Announcements emoji::mega: label:"Announcements"

Step 3: Send the Panel

Send Panel

/reactionrole create channel:#roles title:"Get Your Roles!" type:buttons

Note

Menus are identified by the ID of the message they were posted as. Use /reactionrole list to see every menu in the server and its message ID.

Button vs Dropdown Modes

Button Mode

Each role gets its own clickable button. Best for smaller role lists where visual distinction is important.

Choose Your Colors

• Red Blue Green Purple

Dropdown Mode

Roles appear in a dropdown menu. Great for longer lists or when you want multiple selections at once.

Notification Preferences

Select your roles...

Pro Tip

Use dropdown mode with "require role" to create role-restricted options that only certain members can see and select.

Customization Options

• Button Colors Choose from Primary (blue), Secondary (gray), Success (green), or Danger (red). color:green
• Custom Emojis Use any emoji, including custom server emojis. emoji:<:custom:123>
• Label Text Custom text for buttons or dropdown options. label:"My Role"
• Description For dropdowns, add descriptions to explain each role. description:"Info..."
• Unique Mode Only allow one role from the panel at a time. unique:true
• Required Role Require a role to use the panel. require:@Member

Embed Customization

Customize the panel embed with title, description, color, and image:

Customize Embed

/reactionrole create channel:#roles title:"Get Your Roles!" description:"Click a button below to get your role!" color:#00A896

Managing Panels

Command	Description
/reactionrole create	Create a new reaction role menu and post it
/reactionrole add-option	Add a reaction option to a menu
/reactionrole remove-option	Remove a reaction option from a menu
/reactionrole list	List all reaction role menus in this server
/reactionrole delete	Delete a reaction role menu

Warning

Deleting a panel will also remove any sent messages. Make sure you have a backup if needed.

Tips & Tricks

1

Organize with Multiple Panels

Create separate panels for different role categories (colors, notifications, games, etc.) instead of cramming everything into one panel.

2

Use Unique Mode for Exclusive Roles

For color roles or rank badges, enable unique mode so members can only have one role from the panel at a time.

3

Role Hierarchy Matters

Make sure Natsumi's role is higher than the roles you want to assign. The bot can't give roles higher than its own.

4

Use Clear Labels

Even if you use emojis, add descriptive labels so members know exactly what each role is for.

5

Update After Changes

Menus are edited on the dashboard, under Reaction Roles, which updates the posted message in place.