Configuration: Reaction Roles

Reaction Roles allow users to assign themselves roles by reacting to specific messages in your Discord server. This section of the control panel lets you create, manage, and configure these reaction role menus.

Overview

The Reaction Roles feature is organized into "menus." Each menu corresponds to a single message in a specific channel, where users can react to gain predefined roles. You can have multiple menus active simultaneously in different channels or for different purposes.

Managing Reaction Role Menus

The main Reaction Roles page displays a list of all the menus you have configured for the server.

  • Listing Menus: You'll see existing menus, likely showing their names and potentially the channel they are active in.
  • Creating a New Menu:
    • Click the "Create New Menu" (or similar) button.
    • A new menu placeholder is created with a default name (e.g., "New Reaction Role Menu").
    • You will be automatically taken to the editor page to configure the specifics of this new menu.
  • Editing an Existing Menu: Click on a menu in the list (e.g., on an "Edit" button or the menu name) to open the editor and modify its settings.
  • Deleting a Menu: Options to delete a menu are typically available either directly in the list view or within the menu editor. Deleting a menu will remove its associated message and reaction functionality.

Configuring a Menu (Editor)

When you create a new menu or edit an existing one, you'll access the menu editor. Here, you define how the reaction role system will work for that specific message:

  • Menu Name: Assign a descriptive name to easily identify the menu later (e.g., "Notification Roles," "Team Assignments").
  • Channel Selection: Choose the specific text channel within your server where the reaction role message will be posted and managed by the bot.
  • Message Content: Define the message that users will see and react to. This often includes instructions on what each reaction means. You can typically configure both standard text and embed messages for a richer appearance.
  • Reaction-Role Pairs: This is the core of the configuration.
    • Add pairs consisting of an emoji (the reaction) and a Discord role.
    • When a user adds the specified reaction to the message, they will be granted the corresponding role.
    • You can usually configure advanced options per pair, such as:
      • Assigning the role only once (preventing users from getting it multiple times).
      • Removing the role if the user removes their reaction.
      • Different modes (e.g., toggle role, add only, remove only).
    • You can add multiple reaction-role pairs to a single menu/message.
  • Saving Changes: Once configured, save the menu. The bot will then either post a new message (for new menus) or update the existing one (if editing) in the selected channel with the configured reactions.

Example Use Case

You could create a menu in a #get-roles channel with a message like "React to get notified about announcements!" using a bell emoji (🔔) linked to an `@Announcements` role. Users reacting with 🔔 would automatically receive the `@Announcements` role.