Reaction Roles
Build self-assignable roles using reactions, dropdowns, and persistent buttons.
Choose an interaction#
Use emoji reactions for a simple message-to-role mapping, or create a named dropdown draft with role options. A named menu can switch between dropdown and button modes without being recreated.
Draft, configure, then publish#
Create a draft, add role options, and review selection limits before sending it. A draft can also attach to a Weepy-authored message or supported static Components V2 layout. Manage Server and Manage Roles are required.
Check the configuration#
Use reactionrole check for a published message, or dropdown view for a named menu. Review role hierarchy, destination permissions, and whether deselection removes roles.
,reactionrole list <channel>Edit without unexpected removals#
Removing a dropdown option does not bulk-revoke roles already assigned. Detach keeps the draft and assigned roles. Delete removes the menu configuration and component while keeping the message and roles. Emoji reaction-role reset does not delete dropdown menus.
Command reference
Expand a command for its syntax, permissions, and examples.
Lets members toggle roles using persistent message buttons
- Aliases
- buttonroles
- Parameters
- n/a
- Requires
- Manage Roles
,buttonroleAdds a persistent self-role button to a weepy message
- Aliases
- None
- Parameters
- message link, role, style, emoji, label
- Requires
- Manage Roles
,buttonrole add (message link) (role) (style) (emoji) (label)Removes one numbered button from a message
- Aliases
- delete
- Parameters
- message link, button number
- Requires
- Manage Roles
,buttonrole remove (message link) (button number)Removes every role button from one message
- Aliases
- None
- Parameters
- message link
- Requires
- Manage Roles
,buttonrole removeall (message link)Lists every configured button role
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Roles
,buttonrole listRemoves every button-role configuration
- Aliases
- clear
- Parameters
- n/a
- Requires
- Manage Roles
,buttonrole resetSets up self-assignable roles with emoji reactions, dropdowns or buttons
- Aliases
- reactionroles
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionroleAdds a reaction role to a message
- Aliases
- None
- Parameters
- message link, emoji, role
- Requires
- Manage Server, Manage Roles
,reactionrole add (message link) (emoji) (role)Checks a reaction-role message, role hierarchy and channel permissions without changing it
- Aliases
- diagnose
- Parameters
- message link
- Requires
- Manage Server, Manage Roles
,reactionrole check (message link)Create persistent role dropdowns or buttons; button/buttons aliases create button menus by default
- Aliases
- menu, select, button, buttons
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdownOpens the editor for a configured reaction-role message
- Aliases
- None
- Parameters
- message link
- Requires
- Manage Server, Manage Roles
,reactionrole edit (message link)Lists reaction roles, optionally filtered to a channel
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole list <channel>Removes a reaction role from a message
- Aliases
- None
- Parameters
- message link, emoji
- Requires
- Manage Server, Manage Roles
,reactionrole remove (message link) (emoji)Removes all reaction roles from a message
- Aliases
- None
- Parameters
- message link
- Requires
- Manage Server, Manage Roles
,reactionrole removeall (message link)Clears every emoji reaction-role mapping; dropdown menus are deleted separately
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole resetToggles restoring emoji and dropdown roles when members rejoin
- Aliases
- None
- Parameters
- setting
- Requires
- Manage Server, Manage Roles
,reactionrole restore (on|off)Adds a role option; quote labels with spaces, use - for no emoji
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown add (name) (role) <label> <emoji> <description>Attaches a draft to a Weepy-authored classic embed/message or static Components V2 layout
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown attach (name) (message link)Creates a named draft role dropdown (default: zero or one selection)
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown create (name)Deletes a menu configuration and removes its dropdown; keeps the message and assigned roles
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown delete (name)Removes the component and keeps the menu as a reusable draft; roles are kept
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown detach (name)Edits placeholder/min/max/remove/mode/title/description/content, or text for V2; use - to clear classic text
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown edit (name) (field) (value)Lists this server's drafts and published dropdown menus
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown listSets the maximum (1 for single-select, up to 25 for multi-select)
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown max (name) (number)Sets minimum selections; use 0 to allow clearing every selected role
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown min (name) (number)Switches an existing named menu between dropdown and buttons in place
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown mode (name) (dropdown|buttons)Edits an existing option's label, emoji and description without reposting
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown option (name) (role) <label> <emoji> <description>Sets the text displayed on the collapsed dropdown
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown placeholder (name) (text)Controls deselection removal; add-only mode requires max above 1
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown removal (name) (on|off)Removes an option by role mention/ID; does not bulk revoke roles already given
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown remove (name) (role or role ID)Publishes a draft menu in this channel or a specified channel
- Aliases
- publish
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown send (name) <channel>Changes a role button's color; labels/emojis/descriptions use option
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown style (name) (role) (gray|blue|green|red)Refreshes the existing dropdown after a failed edit, without reposting or changing its embed
- Aliases
- None
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown sync (name)Shows configuration, role options and hierarchy/permission problems
- Aliases
- check
- Parameters
- n/a
- Requires
- Manage Server, Manage Roles
,reactionrole dropdown view (name)