Button Roles
Allow users to claim roles by clicking interactive buttons.
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]
Customization 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.