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

# Reaction Roles

> Allow members to self-assign roles by reacting to messages.

## Overview

Reaction roles are an easy way for users to pick up roles for notifications, colors, or access to different parts of your server.

## Configuration

To set up a reaction role, you need a message link, the emoji, and the role name.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,reactionrole add (message_link) (emoji) (@role)
  ```

  ```javascript Example theme={null}
  ,reactionrole add https://discord.com/channels/... :verified: @Member
  ```
</CodeGroup>

<Info>
  You can add **multiple different emojis** to the same message to create a full reaction-based menu. Each emoji can be linked to a different role.
</Info>

<Info>
  The message link can be obtained by right-clicking a message and selecting **Copy Message Link**.
</Info>

## Managing Reaction Roles

### Viewing existing roles

Use the list command to see all reaction roles currently active in your server.

```javascript theme={null}
,reactionrole list
```

### Removing a reaction role

If you no longer want a specific reaction role, you can remove it using the same message link and emoji.

```javascript theme={null}
,reactionrole remove (message_link) (emoji)
```

### Clearing all roles

To remove every reaction role from a message or the entire server, use the clear command.

```javascript theme={null}
,reactionrole clear [message_link]
```

<Tip>
  greed will automatically attempt to add the reaction to the message when you create the reaction role. Make sure the bot has permission to react in that channel!
</Tip>
