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

# Reaction Roles

<Card title="Module: Reaction Roles" icon="files" horizontal="True">
  Setup reaction roles for members to receive roles from message reactions
</Card>

## Adding a reaction role

<Tabs />

To add a reaction role, use the `reactionroles add` command

<CodeGroup>
  ```javascript syntax theme={null}
  ,reactionroles add (message) (role) (emoji)
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/rr-add.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=c19a862250da0e03ea5301b0eeec2ae6" width="466" height="136" data-path="images/rr-add.png" />
</Frame>

## Removing a reaction role

<Tabs />

<Info>
  To remove **all** reaction roles, use `reactionroles clear`
</Info>

To remove a reaction role, use the `reactionroles remove` command

<CodeGroup>
  ```javascript syntax theme={null}
  ,reactionroles remove (message)
  ```

  ```javascript syntax theme={null}
  ,reactionroles remove (message id)
  ```
</CodeGroup>

## Viewing Reaction Roles

To view the active reaction roles, execute `reactionroles list`

<CodeGroup>
  ```javascript syntax theme={null}
  ,reactionroles list
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/AalZmPvrgh2Es8UR/images/rr-list.png?fit=max&auto=format&n=AalZmPvrgh2Es8UR&q=85&s=a039cc47f91e2df5bd796b9b9d5f304b" width="332" height="184" data-path="images/rr-list.png" />
</Frame>

## Use cases

Reaction roles can be used for a **multitude** of things inside your server. We will list a couple here.

1. Verification system - Users react to your rules message to receive your verified role
2. Booster roles - Open channels to your server boosters where they can react to receive another role
3. Color, content, or age roles - It also allows you to to configure all of those in **3 minutes or less!**