Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.p2w.lol/llms.txt

Use this file to discover all available pages before exploring further.

Allow your members to assign themselves roles by clicking a button.

What are button roles?

Button roles are roles that are assigned to members when they click a button on an existing message or embed. They can be useful for letting members choose unique roles or as a way to verify themselves.

Creating a button role

You can create multiple button roles for a single message.
Button roles can only be placed on messages & embeds sent by bleed. Learn how to create an embed here!
.buttonrole add (message link) (role) (style) (emoji) (label)

// Available styles: "green," "blurple," "gray," or "red."
Screenshot 2026 04 15 At 1 58 08 AM
Screenshot 2026 04 15 At 1 58 32 AM
Screenshot 2026 04 15 At 1 59 23 AM

Removing a button role

You can remove a specific button role by using the buttonrole remove command.
You can use the buttonrole list command to see all button roles in your server.
Screenshot 2026 04 15 At 2 00 30 AM
.buttonrole remove (message link) (button number)
Screenshot 2026 04 15 At 2 02 15 AM

Removing all button roles for a message

Additionally, you can remove all button roles from a message by using the buttonrole removeall command.
.buttonrole removeall (message link)
Screenshot 2026 04 15 At 2 03 29 AM

Removing all button roles from the server

You can remove all button roles from the server by using the buttonrole reset command.
Please note that this cannot be undone & will permanently remove all button roles from the server.
.buttonrole reset
Screenshot 2026 04 15 At 2 04 42 AM