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

# Button Messages

> Add buttons to raze messages that send an ephemeral embed response when clicked.

# Button Messages

> Add buttons to raze messages that send an ephemeral embed response when clicked.

## Overview

Button messages attach a persistent button to any message sent by raze. When a member clicks it, raze sends them an ephemeral embed response — visible only to them. Multiple buttons can coexist on the same message alongside [button roles](/server-config/button-roles).

Each button gets a unique **code** that you use to remove it later.

<Warning>
  Buttons can only be added to messages sent by raze.
</Warning>

## Add a button message

<CodeGroup>
  ```bash Syntax theme={null} theme={null}
  ;buttonmessage add (message link) (label) [style] (embed code)
  ```

  ```bash Example theme={null} theme={null}
  ;buttonmessage add https://discord.com/channels/.../... Info primary {embed}$v{description: Hello!}
  ```
</CodeGroup>

| Parameter      | Required | Description                        |
| -------------- | -------- | ---------------------------------- |
| `message link` | Yes      | Link to a raze message             |
| `label`        | Yes      | Button label text                  |
| `style`        | No       | Button color — see styles below    |
| `embed code`   | Yes      | Embed code starting with `{embed}` |

### Button styles

| Style                         | Color          |
| ----------------------------- | -------------- |
| `primary` / `blue`            | Blue (default) |
| `secondary` / `gray` / `grey` | Grey           |
| `success` / `green`           | Green          |
| `danger` / `red`              | Red            |

### Embed code format

The embed code must start with `{embed}` and uses the same embed builder syntax as welcome messages and other embeds in raze.

```bash theme={null} theme={null}
{embed}$v{description: Welcome! Read the rules in #rules.}$v{color: #5865F2}
```

## Remove a button message

```bash theme={null} theme={null}
;buttonmessage remove (code)
```

Use the code returned when the button was added.

## List button messages

```bash theme={null} theme={null}
;buttonmessage list
```

Shows all button messages in the server with their codes, labels, and styles.

***

## Full example

```bash theme={null} theme={null}
;say Need help? Click a button below.
;buttonmessage add https://discord.com/channels/.../... Rules primary {embed}$v{title: Server Rules}$v{description: 1. Be respectful\n2. No spam}
;buttonmessage add https://discord.com/channels/.../... FAQ green {embed}$v{title: FAQ}$v{description: Check #faq for common questions.}
```