> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quarkybot.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Button-Based Reaction Roles in Discord Servers

> Create styled reaction role embeds with clickable buttons that automatically grant or remove Discord roles when members click them in your server.

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

<Steps>
  <Step>
    Run `/reaction-roles create [name]` and provide a unique name for your embed.

    ![](https://imgur.com/J93IHAZ.png)
  </Step>

  <Step>
    After running the command, a configuration wizard will appear where you can customize the embed and associated roles.

    ![](https://imgur.com/MdX3ayN.png)
  </Step>

  <Step>
    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.

    ![](https://imgur.com/Taz3OFH.png)
  </Step>

  <Step>
    The embed will update instantly to reflect your configuration.

    ![](https://imgur.com/QEZWF4c.png)
  </Step>

  <Step>
    Click the **Roles** button to begin adding reaction roles.

    ![](https://imgur.com/H5CgyaT.png)
  </Step>

  <Step>
    Click **Add Role** to create a new role button.

    ![](https://imgur.com/WpGsX3b.png)
  </Step>

  <Step>
    Choose the role from the dropdown menu that will be assigned to users.

    ![](https://imgur.com/3Oizxcq.png)
  </Step>

  <Step>
    Click **Button** and configure:

    | Setting      | Options                                      |
    | ------------ | -------------------------------------------- |
    | Button Label | Text displayed on the button                 |
    | Button Color | `0` Grey · `1` Blurple · `2` Green · `3` Red |
    | Button Emoji | Emoji shown on the button                    |

    Click **Submit** when done.

    ![](https://imgur.com/lrd3I8U.png)
  </Step>

  <Step>
    Click **Save** to finalize your reaction roles embed.

    ![](https://imgur.com/kw7iEPO.png)
  </Step>

  <Step>
    After saving, you can:

    * **Send** the embed to a channel
    * **Edit** it
    * **Delete** it

    ![](https://imgur.com/9rt0W0B.png)
  </Step>

  <Step>
    Click **Send** and choose a channel. Once posted, users can click buttons to get or remove roles (clicking again removes the role).

    ![](https://imgur.com/QEum40L.png)

    ![](https://imgur.com/pZ3ixId.png)
  </Step>
</Steps>

<Note>
  Clicking a button a second time removes the role. Members can toggle their roles on and off at any time.
</Note>

## Slash commands

| Command                         | Description                                                      |
| ------------------------------- | ---------------------------------------------------------------- |
| `/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 list`          | List all saved reaction role embed names                         |