ButtonRoles
Let members click a button to get, remove, or toggle a role.
ButtonRoles are simple — click a button, the app gives, removes, or switches a role. No forms, no menus.
Limits
Amount
- Up to 25 ButtonRoles per message
- Only works on the bot's own messages
- Up to 5 roles per ButtonRole (4 if a required role is specified)
- Role names cannot exceed 50 characters
Labels
- All emojis must be valid Discord emojis
- Label character limit is 80
- With 2 or more roles, a custom label is required
Requirements
Make sure all requirements are met before setting up a ButtonRole.
- Role(s) must be below the bot's highest role in the role list
- The bot must have MANAGE_ROLES, EMBED_LINKS, and MANAGE_MESSAGES permissions
ButtonRole Types
| Type | Behavior |
|---|---|
| Toggle | Adds the role if the user doesn't have it, removes it if they do |
| Give | Only adds the role — never removes it |
| Remove | Only removes the role — never adds it |
How to set up
/buttonrole create
- 1
Type /buttonrole create
- 2
Select the type — Toggle, Give, or Remove
- 3
Select the role(s) to assign
- 4
Provide the message URL of the target message
- 5
Optionally set a label and emoji
- 6
Send the command
Click to enlarge
For setting up multiple buttons at once, see the Bulk Setup page.