> For the complete documentation index, see [llms.txt](https://docs.evelina.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.evelina.bot/server/roles/button.md).

# 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 <a href="#creating-a-button-role" id="creating-a-button-role"></a>

You can create multiple button roles for a single message.

{% hint style="warning" %}
Button roles can only be placed on messages & embeds sent by evelina. Learn how to create an embed [**here**](/resources/scripting/embeds.md)!
{% endhint %}

```
Syntax: ;buttonrole add [message] [role] [label] [emoji] [color]
Example: ;buttonrole add .../channels/... member Verify ✅ green
```

<figure><img src="https://github.com/EvelinaServices/docs/blob/main/.gitbook/assets/Screenshot%202025-01-04%20000538.png" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If you don't want a name or an emoji on the button, you can enter "none" as the name/emoji for either of them.
{% endhint %}

## Removing a button role

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

{% hint style="info" %}
You can use the `buttonrole list` command to see all button roles in your server.
{% endhint %}

<figure><img src="https://github.com/EvelinaServices/docs/blob/main/.gitbook/assets/Screenshot%202025-01-04%20000603.png" alt=""><figcaption></figcaption></figure>

```
Syntax: ;buttonrole remove [button_id]
Example: ;buttonrole remove 5j4ji97J
```

<figure><img src="https://github.com/EvelinaServices/docs/blob/main/.gitbook/assets/Screenshot%202025-01-04%20000631.png" alt=""><figcaption></figcaption></figure>

## Removing all button roles for a message <a href="#removing-all-button-roles-for-a-message" id="removing-all-button-roles-for-a-message"></a>

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

```
Syntax: ;buttonrole clear [message]
Example: ;buttonrole clear .../channels/...
```

<figure><img src="https://github.com/EvelinaServices/docs/blob/main/.gitbook/assets/Screenshot%202025-01-04%20000656.png" alt=""><figcaption></figcaption></figure>