Server configuration | Roles
Button Roles
Allow users to claim roles by clicking interactive buttons.
Slash commands for this page
Set this up in Discord with /configure feature:Button roles.
Use the slash version of each command below. Prefix commands keep working until March 5, 2027. What is changing
,buttonrole remove→/configure feature:Button roles,buttonrole list→/configure feature:Button roles,buttonrole removeall→/configure feature:Button roles,buttonrole reset→/configure feature:Button roles
Overview
Button roles are a modern, high-conversion way to handle self-assigning roles. Unlike reactions, buttons provide a clear call to action and support custom labels and styles.
Requirements & Limits
- Bot Permission: greed requires the Manage Roles permission.
- Role Hierarchy: greed's role must be above the roles it grants for the feature to work.
- Message Limit: Each message can have a maximum of 25 buttons.
- Message Edit Permission: greed must have permission to edit the message to add buttons (if sent by greed).
Creating Button Roles
To create a button role, you must first have an existing message (sent by anyone) that the buttons will be attached to.
,buttonrole add (message_link) (role) [style] [emoji] [label],buttonrole add https://discord.com/... @Announcements blurple :bell: Notify MeCustomization Options
Button Styles
You can customize the appearance of the button using these style names or colors:
| Style | Color |
|---|---|
primary / blurple | Blurple (Discord Blue) |
secondary / grey | Grey |
success / green | Green |
danger / red | Red |
Label & Emoji
- Label: The text displayed on the button. If omitted, it defaults to the role's name.
- Emoji: You can use standard or custom emojis on the button.
Technical Details
Buttons are indexed starting at 1. When you use ,buttonrole remove, refer to the button's position in the list.
If a role assigned by a button is deleted from your server, users can still click the button, but the role assignment will silently fail. Delete the button using ,buttonrole remove if the role no longer exists.
Management Commands
,buttonrole list: View all messages that currently have button roles attached.,buttonrole remove (message_link) (index): Remove a specific button by its index number.,buttonrole removeall (message_link): Clear all buttons from a message.,buttonrole reset: Clear every button role configuration in the server.