Server configuration | Roles

Button Roles

Allow users to claim roles by clicking interactive buttons.


Note:

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]

Customization Options

Button Styles

You can customize the appearance of the button using these style names or colors:

StyleColor
primary / blurpleBlurple (Discord Blue)
secondary / greyGrey
success / greenGreen
danger / redRed

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.

Warning:

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.