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

# Reaction Roles

Allow your members to assign themselves roles by reacting to a message.

## What are reaction roles?

Reaction roles are roles that are assigned to members when they react to a message. This can be useful for letting members choose unique roles or as a way to verify themselves.

### Creating a reaction role

You can create multiple reaction roles for a single message with a different emoji for each role.

<Info>
  You can find the message link by **right-clicking** or **holding down** on the message and selecting **Copy Message Link**.
</Info>

<CodeGroup>
  ```typescript file name theme={null}
  .reactionrole add (message link) (emoji) (role)
  ```

  ```typescript file name theme={null}
  .reactionrole add .../channels/... ✅ @Member
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.37.37-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=3a6858e2323605e1eb16165a11895c07" alt="Screenshot 2026 04 14 At 5 37 37 PM" width="1984" height="360" data-path="images/Screenshot-2026-04-14-at-5.37.37-PM.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.38.19-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=a61a3fc8b347b73b4160804b108b1815" alt="Screenshot 2026 04 14 At 5 38 19 PM" width="1280" height="504" data-path="images/Screenshot-2026-04-14-at-5.38.19-PM.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.38.53-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=7b829e61840db45970833d04cfabaf54" alt="Screenshot 2026 04 14 At 5 38 53 PM" width="830" height="592" data-path="images/Screenshot-2026-04-14-at-5.38.53-PM.png" />
</Frame>

### Removing a reaction role

You can remove a reaction role by using the `reactionrole remove` command.

<Tip>
  You can use the `reactionrole list` command to see all reaction roles and their emojis.

  <Frame>
    <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.41.18-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=aae9863012672661749d319f8d98f87c" alt="Screenshot 2026 04 14 At 5 41 18 PM" width="824" height="628" data-path="images/Screenshot-2026-04-14-at-5.41.18-PM.png" />
  </Frame>
</Tip>

<CodeGroup>
  ```typescript Syntax theme={null}
  .reactionrole remove (message link) (emoji)
  ```

  ```typescript Example theme={null}
  .reactionrole remove .../channels/... ✅
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.43.16-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=3bb4d0f00813efc4b48da5122c344087" alt="Screenshot 2026 04 14 At 5 43 16 PM" width="1212" height="350" data-path="images/Screenshot-2026-04-14-at-5.43.16-PM.png" />
</Frame>

### Removing all reaction roles for a message

You can remove all reaction roles for a message with the `reactionrole removeall` command.

<Info>
  This is different from `reactionrole reset` which removes all reaction roles from the server.
</Info>

<CodeGroup>
  ```typescript Syntax theme={null}
  .reactionrole removeall (message link)
  ```

  ```typescript Example theme={null}
  .reactionrole removeall .../channels/...
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.45.14-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=41c88e2c294a83bb8385fe332e6223d2" alt="Screenshot 2026 04 14 At 5 45 14 PM" width="1250" height="352" data-path="images/Screenshot-2026-04-14-at-5.45.14-PM.png" />
</Frame>

### Removing all reaction roles from the server

You can remove all reaction roles from the server by using the `reactionrole reset` command.

<Warning>
  This **CAN NOT** be undone and will remove **ALL** reaction roles from the server.
</Warning>

<Frame>
  <img src="https://mintcdn.com/drown/wJlYU9DFcrYANP9M/images/Screenshot-2026-04-14-at-5.49.00-PM.png?fit=max&auto=format&n=wJlYU9DFcrYANP9M&q=85&s=d6ed493df6aeb08500757cc6dff44f76" alt="Screenshot 2026 04 14 At 5 49 00 PM" width="844" height="334" data-path="images/Screenshot-2026-04-14-at-5.49.00-PM.png" />
</Frame>

### Setting up a verification system

Reaction roles can be used to create a verification system where members must react to a message to gain access to the server.

<Info>
  In order for this to work, you’ll need to create a role that will be assigned to members when they react to the message, such as a **Member** role.
</Info>
