Button-role panels

Self-assign roles: members give themselves roles by clicking buttons.

With button-role panels members assign roles to themselves — not via reaction emojis, but real Discord buttons.

Create a panel

In the Button roles tab click Create panel:

  • Title, optional description and color
  • the target channel the panel is posted to
  • up to 25 buttons — each maps to one role, with a label, an optional emoji and a style (primary/secondary/success/danger)
  • selection mode: multi-select or single-select
  • optionally a webhook persona (custom name/avatar instead of the bot)

Then publish — the panel appears in the channel.

How members use it

Clicking a button grants (or removes) the mapped role on the main server. If "Propagate to sub-servers" is on, the role is synced to your sub-servers via your role rules — otherwise it stays on the main server only.

Buttons keep working across bot restarts.

Requirements

  • Manage Roles — and the bot role must sit above the roles it grants
  • Manage Webhooks, if you use a webhook persona
Button-role panels — CloudMod Docs | CloudMod