Skip to main content
Quarky’s reaction roles feature lets you post a styled embed with clickable buttons. When a member clicks a button, they receive the associated role instantly. Clicking the same button again removes the role, giving members full control over their own role selection.

​
Setting up reaction roles

1
Run /reaction-roles create [name] and provide a unique name for your embed.
2
After running the command, a configuration wizard will appear where you can customize the embed and associated roles.
3
Click the Embed button and fill in the embed details:
  • Title — heading displayed at the top
  • Description — explanation of the roles
  • Hex Color — embed border color (e.g. #5865F2)
  • Footer — text at the bottom
  • Image — image displayed inside the embed
All fields are optional, but recommended. Click Submit when done.
4
The embed will update instantly to reflect your configuration.
5
Click the Roles button to begin adding reaction roles.
6
Click Add Role to create a new role button.
7
Choose the role from the dropdown menu that will be assigned to users.
8
Click Button and configure:
SettingOptions
Button LabelText displayed on the button
Button Color0 Grey · 1 Blurple · 2 Green · 3 Red
Button EmojiEmoji shown on the button
Click Submit when done.
9
Click Save to finalize your reaction roles embed.
10
After saving, you can:
  • Send the embed to a channel
  • Edit it
  • Delete it
11
Click Send and choose a channel. Once posted, users can click buttons to get or remove roles (clicking again removes the role).
Clicking a button a second time removes the role. Members can toggle their roles on and off at any time.

​
Slash commands

CommandDescription
/reaction-roles create [name]Open the interactive wizard to create a new reaction roles embed
/reaction-roles get [name]Preview a saved embed with Send, Edit, and Delete actions
/reaction-roles listList all saved reaction role embed names