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

# Button Roles

## What are button roles? <a href="#what-are-button-roles" id="what-are-button-roles"></a>

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 assigned to messages or embeds created by serenity. If you don't know how you can create a message or embed, check out our Scripting Guide below.
{% endhint %}

{% content-ref url="/pages/y71W8TwxPtQLLFBBrGCJ" %}
[Writing Embed Code](/embeds/writing-embed-code.md)
{% endcontent-ref %}

```
Syntax: ;buttonroles add [message] [name] [emoji] [color] [roles]
Example: ;buttonroles add .../channels/... Verify ✅ green, @Member
```

{% hint style="info" %}
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 %}

<figure><img src="/files/5aRVkaI3O27NjdLogVTk" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
You can append more than one role on a Button, simple split them with a comma.
{% 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="/files/SFjdHVp54M4qkWQfBHcc" alt=""><figcaption><p>List all buttonroles for the server</p></figcaption></figure>

```
Syntax: ;buttonroles remove [message] [name]
Example ;buttonroles remove .../channels/... Verify
```

<figure><img src="/files/ZqdAEnW7QI2ctpmK4eG0" alt=""><figcaption></figcaption></figure>

## Removing all button roles for a message

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

```
Syntax: ;buttonroles removeall [message]
Example: ;buttonroles removeall .../channels/...
```

<figure><img src="/files/McZPFtSxpZUpJQBbtsPh" alt=""><figcaption></figcaption></figure>
