# 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="../../embeds/writing-embed-code" %}
[writing-embed-code](https://docs.serenity.wtf/embeds/writing-embed-code)
{% 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="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2Fhj62hd57YMjXJPbhIMcc%2Fimage.png?alt=media&#x26;token=20b00cf9-fa96-4e06-9118-e2d742ef1ef8" 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="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2FIAx8M8D0l4UdhfFWkLKC%2Fimage.png?alt=media&#x26;token=60278583-71cc-461b-8786-f5738609c3d3" 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="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2Fc7YKy6sUcxyKct47yhJ0%2Fimage.png?alt=media&#x26;token=f56658bb-15d7-4a9b-97b5-e4a6316506a5" 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="https://2138524749-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKC3Q8gA6avaSjTCmPTwv%2Fuploads%2F0HnjeP5scMb3iQADbJvR%2Fimage.png?alt=media&#x26;token=c31bb7fa-2e42-4de0-9012-7284881382f2" alt=""><figcaption></figcaption></figure>
