Self-Assign

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
/reactionroles create type:buttons title:"Get Your Roles!"

Step 2: Add Roles

Add roles to your panel using the add command:

Add Role to Panel
/reactionroles add panel-id:12345 role:@Announcements emoji:📢 label:"Announcements"

Step 3: Send the Panel

Send Panel
/reactionroles send panel-id:12345 channel:#roles
Note

Each panel gets a unique ID. Use /reactionroles list to see all your panels and their IDs.

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
/reactionroles edit panel-id:12345 description:"Click a button below to get your role!" color:#00A896

Managing Panels

CommandDescription
/reactionroles listView all panels in your server
/reactionroles editEdit panel title, description, color
/reactionroles addAdd a role to a panel
/reactionroles removeRemove a role from a panel
/reactionroles updateRefresh a sent panel message
/reactionroles deleteDelete a panel entirely
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

After editing a panel, use /reactionroles update to refresh any already-sent messages with the new configuration.