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

# Reaction Roles

> Setup roles for users to collect via reactions.

## Introduction

jar can assign roles to users when they react to a message. This can be useful for setting up roles for users to collect, or for setting up a role menu.

## Setting up a reaction role

To setup a reaction role, simply use the `reactionrole add` command, followed by the message link/ID, emoji, and role you'd like to use.

<Tip>To copy a message link, right-click (or long-press on mobile) the message and select **Copy Message Link**.</Tip>

<CodeGroup>
  ```ruby Syntax theme={null}
  reactionrole add <message> <emoji> <role>
  ```

  ```ruby Example theme={null}
  ,,reactionrole add https://discord.com/channels/123/123/123 💀 @Skullers
  ```
</CodeGroup>

## Listing reaction roles

To list all reaction roles in your server, simply use the `reactionrole list` command.
This will show you all the reaction roles, along with their message, emoji, and role.

<CodeGroup>
  ```ruby Syntax theme={null}
  reactionrole list
  ```

  ```ruby Example theme={null}
  ,,reactionrole list
  ```
</CodeGroup>

## Removing a reaction role

There are two ways to remove a reaction role:

* Removing a specific reaction role from a message.
* Removing all reaction roles from a message.

### Removing a single reaction role from a message

To remove one reaction role from a message, simply use the `reactionrole remove` command, followed by the message link/ID and emoji you'd like to remove.
<Info>This will not remove the reaction from the message.</Info>

<CodeGroup>
  ```ruby Syntax theme={null}
  reactionrole remove <message> <emoji>
  ```

  ```ruby Example theme={null}
  ,,reactionrole remove https://discord.com/channels/123/123/123 💀
  ```
</CodeGroup>

### Removing all reaction roles from a message

To remove all reaction roles from a message, simply use the `reactionrole removeall` command, followed by the message link/ID.
<Info>This will not remove the reactions from the message.</Info>

<CodeGroup>
  ```ruby Syntax theme={null}
  reactionrole removeall <message>
  ```

  ```ruby Example theme={null}
  ,,reactionrole removeall https://discord.com/channels/123/123/123
  ```
</CodeGroup>

## Resetting all reaction roles

To reset all reaction roles in your server, simply use the `reactionrole reset` command.

<CodeGroup>
  ```ruby Syntax theme={null}
  reactionrole reset
  ```

  ```ruby Example theme={null}
  ,,reactionrole reset
  ```
</CodeGroup>