Button Roles

Post buttons that give members roles

Button roles let members give themselves a role by clicking a button.

Click a button to add or remove a role. Red Green Blue

Creating them

Build a blueprint on the roles page, pick the roles and labels, then copy the exported data.

Go to the channel you want the buttons in and run /button-roles with that data pasted into the content option.

Clicking a button toggles the role: it adds the role if the member does not have it, and removes it if they do.

Catches and limits

  • Button roles are a premium feature.
  • The bot needs Manage Roles, and its own role must sit above every role it hands out. This is not checked when you post the buttons, so a role that sits too high only fails when a member clicks.
  • Buttons only. Dropdown blueprints are rejected for now, even though the builder may let you make one.
  • A message can contain up to 25 buttons, split across five rows of five.
  • Button labels are capped at 80 characters.
  • Buttons are all the same blurple color, with no custom emoji support yet.
  • There is no exclusive group. Every button is independent, so a member can hold several of the roles at once.
  • The role mapping lives only in the posted message. If the message is deleted, the setup is gone and there is no server-side copy to restore it.