Documentation

Reaction Roles

Command

Parameters

Description

Required Permission

/reactionrole_create

[channel]

Opens a setup wizard that creates a role message with a title and description in the text channel. You then assign roles via emoji, using either Toggle or Unique mode. Premium: Unique groups and an optional dropdown menu instead of emoji reactions.

Manage Roles

/reactionrole_list

none

Shows all reaction role messages on the server, with message ID, title, and the assigned emojis, roles and modes.

Manage Roles

/reactionrole_delete

[message_id]

Removes all reaction roles from a message. You pick the message via autocomplete. The reactions or the dropdown menu are removed from the message as well.

Manage Roles


Required Bot Permissions

For Nexus to assign roles reliably and manage the role messages, the bot's role needs the following Discord permissions:

  • Manage Roles: Assigns and removes roles as soon as members react or make a choice in the dropdown. Important: The bot's role must be placed above every role that is handed out via reaction roles in the role list.

  • Send Messages & Embed Links: Posts the role message as an embed in the selected channel.

  • Add Reactions: Adds the emojis below the message that members use to pick their roles. Not needed for dropdown mode.

  • Manage Messages: In Unique mode, removes a member's previous reaction when they pick another role from the same group, and clears all reactions from the message when it is deleted.

  • View Channel & Read Message History: Finds existing role messages so they can be edited or deleted.