Button Roles

Overview

Button roles attach a persistent button to any message sent by slug. When a member clicks it, the role is toggled — added if they don’t have it, removed if they do. Multiple buttons can coexist on the same message alongside button messages. Each button gets a unique code that you use to remove it later.

Buttons can only be added to messages sent by slug.

Add a button role

;buttonrole add (message link) (label) (role) [style] [emoji]

;buttonrole add https://discord.com/channels/.../... Verify @Members green ✅

Parameter	Required	Description
`message link`	Yes	Link to a slug message
`label`	Yes	Button label text
`role`	Yes	Role to toggle
`style`	No	Button color — see styles below
`emoji`	No	Emoji to display on the button

Button styles

Style	Color
`primary` / `blue`	Blue (default)
`secondary` / `gray` / `grey`	Grey
`success` / `green`	Green
`danger` / `red`	Red

Remove a button role

;buttonrole remove (code)

Use the code returned when the button was added.

List button roles

;buttonrole list

Shows all button roles in the server with their codes, labels, roles, and styles.

Full example

;say Welcome to the server! Pick your roles below.
;buttonrole add https://discord.com/channels/.../... Announcements @Announcements blue 🔔
;buttonrole add https://discord.com/channels/.../... Updates @Updates green 📢
;buttonrole add https://discord.com/channels/.../... Events @Events red 🎉

Get Started

Security

Server Configuration

Economy

Miscellaneous

Integrations

Resources

Button Roles

Overview

Add a button role

Button styles

Remove a button role

List button roles

Full example

​Overview

​Add a button role

​Button styles

​Remove a button role

​List button roles

​Full example

Overview

Add a button role

Button styles

Remove a button role

List button roles

Full example