Moderation 5 min read

Creating Reaction Roles

Set up a reaction role system so members can self-assign roles by clicking emoji reactions.

What Are Reaction Roles?

Reaction roles let your members assign roles to themselves by reacting to a message with specific emojis. It's a great way to let members choose notification preferences, colors, or access to specific channels.

Creating Your First Reaction Role

1

Create the Roles

First, create the roles you want members to be able to self-assign in your Server Settings → Roles. Make sure these roles are below Mitsuki's role.

2

Use the Reaction Role Command

In the channel where you want the reaction role message, use:

reactionrole create

This starts the setup wizard that guides you through the process.

3

Add Emoji-Role Pairs

The wizard will ask you to associate emojis with roles. For each role:

  • Select the emoji (can be custom or standard)
  • Choose which role it assigns
  • Add as many pairs as you need
4

Customize the Message

You can customize the embed message that displays the reaction roles:

  • Set a custom title and description
  • Choose embed color
  • Add instructions for members
5

Publish!

Confirm your setup and Mitsuki will post the reaction role message. Members can now click the reactions to get their roles!

Pro Tip Create a dedicated #roles channel to keep your reaction role messages organized and easy to find for new members.

Reaction Role Types

Mitsuki supports different modes for reaction roles:

  • Normal - Members can have multiple roles from the same message
  • Unique - Members can only have one role at a time (removes others when selecting new)
  • Toggle - Clicking again removes the role

Managing Existing Reaction Roles

To edit or delete reaction roles, use:

reactionrole list

This shows all active reaction role messages. You can then edit or delete them as needed.