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

# Button Roles

Allow your members to assign themselves roles by clicking a button.

### What are button roles?

Button roles are roles that are assigned to members when they click a button on an existing message or embed. They can be useful for letting members choose unique roles or as a way to verify themselves.

### Creating a button role

You can create multiple button roles for a single message.

<Warning>
  Button roles can only be placed on messages & embeds sent by bleed. Learn how to create an embed **here!**
</Warning>

<CodeGroup>
  ```typescript Syntax theme={null}
  .buttonrole add (message link) (role) (style) (emoji) (label)

  // Available styles: "green," "blurple," "gray," or "red."
  ```

  ```typescript Example theme={null}
  .buttonrole add .../channels/... Verified green ✅ Verify
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-1.58.08-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=7b9b1a61bc05a86980c139ef4b548f20" alt="Screenshot 2026 04 15 At 1 58 08 AM" width="1894" height="486" data-path="images/Screenshot-2026-04-15-at-1.58.08-AM.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-1.58.32-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=051d29edf0623122e814a694128780c0" alt="Screenshot 2026 04 15 At 1 58 32 AM" width="1326" height="734" data-path="images/Screenshot-2026-04-15-at-1.58.32-AM.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-1.59.23-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=3f7b2ac2813fa6fd5cb8f18151fe9aeb" alt="Screenshot 2026 04 15 At 1 59 23 AM" width="804" height="754" data-path="images/Screenshot-2026-04-15-at-1.59.23-AM.png" />
</Frame>

### Removing a button role

You can remove a specific button role by using the `buttonrole remove` command.

<Tip>
  You can use the `buttonrole list` command to see all button roles in your server.

  <Frame>
    <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-2.00.30-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=dcf3464169fd6be4480b1e698ef5d70c" alt="Screenshot 2026 04 15 At 2 00 30 AM" width="742" height="616" data-path="images/Screenshot-2026-04-15-at-2.00.30-AM.png" />
  </Frame>
</Tip>

<CodeGroup>
  ```typescript Syntax theme={null}
  .buttonrole remove (message link) (button number)
  ```

  ```typescript Example theme={null}
  .buttonrole remove .../channels/... 1
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-2.02.15-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=23c6c29386db5234f4a74188e944e52c" alt="Screenshot 2026 04 15 At 2 02 15 AM" width="1166" height="344" data-path="images/Screenshot-2026-04-15-at-2.02.15-AM.png" />
</Frame>

### Removing all button roles for a message

Additionally, you can remove all button roles from a message by using the `buttonrole removeall` command.

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

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

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-2.03.29-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=1d08be940d3343929e3bb367a4bca86b" alt="Screenshot 2026 04 15 At 2 03 29 AM" width="1240" height="352" data-path="images/Screenshot-2026-04-15-at-2.03.29-AM.png" />
</Frame>

### Removing all button roles from the server

You can remove all button roles from the server by using the `buttonrole reset` command.

<Warning>
  Please note that this **cannot** be undone & will **permanently** remove **all** button roles from the server.
</Warning>

```typescript theme={null}
.buttonrole reset
```

<Frame>
  <img src="https://mintcdn.com/drown/8aQmz48wnWiF8WH9/images/Screenshot-2026-04-15-at-2.04.42-AM.png?fit=max&auto=format&n=8aQmz48wnWiF8WH9&q=85&s=155f3dd0f3d152de9ee94cdf94f4f012" alt="Screenshot 2026 04 15 At 2 04 42 AM" width="826" height="386" data-path="images/Screenshot-2026-04-15-at-2.04.42-AM.png" />
</Frame>
