---
description: Button role will help you to create self-assignable discord roles.
---

# Button Role

![Button Role](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mh-NqscL076EyFAnMlW%2F-Mh4FfmxcPW_NUiWGsIc%2F-Mh4_qrVJEGPVvibjtGC%2FScreen%20Shot%202021-08-14%20at%209.55.48%20AM.png?alt=media\&token=b8ede89a-2af9-4dd9-8da0-9a9fb8b092b1)

{% hint style="info" %}
<mark style="color:blue;">**Good to know:**</mark> Button Role will allow you to set button color, create button with **Label**, **Emoji & Label**, or **Emoji** Only.&#x20;
{% endhint %}

{% hint style="success" %}
<mark style="color:green;">**Tips:**</mark> With **Button Role Limit**, you can now limit how many users can claim it before the button is disabled. Example from the image above: Weekly Deals (10 remaining).
{% endhint %}

![Add Role Message](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FdPsISykxugXv8zBVfsxB%2FScreen%20Shot%202022-02-10%20at%201.57.53%20PM.png?alt=media\&token=d9524fa4-21ab-4ea4-84b6-02053eb2576a)

## Use Cases

* To create self role system
* To share limited role
* Confirmation button

## /button create role&#x20;

Add button role to bot existing messages.

![/button create role](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FNxCepBNW1RF3gaGrleUh%2Fbutton_add.gif?alt=media\&token=812bc34c-882d-4b6e-823b-302e479f561d)

### Command

| Usage                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------- |
| /button create role \[message\_link] \[role\_1] (label) (emoji) (color) (limit) (role\_2 to role\_5) (add\_role\_message) (remove\_role\_message) |

| Example                                                                                                                                                                                                                                                                          |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /button create role `message_link:`[`https://discord.com/channels/940682906983075891/941235459596636160/941375669768687626`](https://discord.com/channels/940682906983075891/941235459596636160/941375669768687626) `role_1:@Role B` `label:Role B` `emoji:`:smile: `color:Blue` |

{% hint style="danger" %}
<mark style="color:red;">**Important:**</mark> By default only members with **Manage Server** can use this command. See [Discord Slash Command Permissions](../../moderator-features/settings-features/discord-slash-command-permissions) to customize it.
{% endhint %}

{% hint style="warning" %}
<mark style="color:orange;">**Check this:**</mark> \[] is a required command option, () is an optional command option.
{% endhint %}

### Command Options

| Option                         | Description                                                                                |
| ------------------------------ | ------------------------------------------------------------------------------------------ |
| message\_link                  | Specify message by the link or ID                                                          |
| role\_1                        | Specify role to apply                                                                      |
| label                          | Custom button label                                                                        |
| emoji                          | Add emoji to your button label                                                             |
| color \<Gray>                  | Choose gray color for your button (Default)                                                |
| color \<Blue>                  | Choose blue color for your button                                                          |
| color \<Green>                 | Choose green color for your button                                                         |
| color \<Red>                   | Choose red color for your button                                                           |
| limit                          | Set button limit before deactivate                                                         |
| role\_2 to rol&#x65;_\__&#x35; | Add additional role to the button                                                          |
| role\_mode \<Add & Remove>     | Set role mode to add or remove role it depends if the author has the role or not (Default) |
| role\_mode \<Add Only>         | Set role mode to add role only                                                             |
| role\_mode \<Remove Only>      | Set role mode to remove role only                                                          |
| add\_role\_message             | Customize the message that user will receive when the role is added                        |
| remove\_role\_message          | Customize the message that user will receive when the role is removed                      |

{% hint style="info" %}
<mark style="color:blue;">**Good to know:**</mark> Go to [variables](../../../getting-started/variables#what-is-variables) page to learn on how to design your message using variables.
{% endhint %}

{% hint style="info" %}
<mark style="color:blue;">**Good to know:**</mark> You also can use [discord markdown](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-) to design your message.
{% endhint %}
