Skip to main content

/reactionroles add

Admin Command

This command requires administrator permissions.

Specify roles to assign when users react to the message.

Usage

/reactionroles add [channel] [message_id] [role] [reaction] (remove_others) (queue_role)

Arguments

  • channel: (Required) Channel where message is.
  • message_id: (Required) Message to add reaction to.
  • role: (Required) Role to assign/remove.
  • reaction: (Required) Reaction that corresponds to this role.
  • remove_others: (Optional) If the user has this role, remove all other reactionroles in the message they have.
  • queue_role: (Optional) Option role for /roles that the user will default to.

Details

Assigns a Discord role to users when they react to a specific message by mapping an emoji to a role; the bot adds the role when the reaction is added and removes it when the reaction is removed. This admin-only action can optionally strip other reaction-assigned roles on that message when a mapped reaction is chosen and can designate a default queue role for listings, making it useful for self-assignable role menus, event sign-ups, and controlled access workflows.

Required Permissions

Permission Required

This command requires either:

  • A configured NeatQueue Staff Role
  • Manage Channels permission