Overview
Button roles attach clickable buttons to a message. A member clicks one, gets the role, clicks again to drop it. Common uses are pronoun pickers, ping opt-ins, and verification gates.You need Manage Roles to run these commands, and confine needs it too.
Adding a button
Targeting the message
Two formats work:Styles
Pick one ofgreen, blurple, gray, or red. This is purely visual — it doesn’t change what the button does.
Labels and emojis
Labels cap at 80 characters. Emojis can be standard Unicode or a custom emoji, as long as it’s one confine has access to.Limits
Roles confine won’t accept
Some roles are blocked on purpose:Roles with dangerous permissions
Roles with dangerous permissions
A self-assignable role that grants moderation power is a security hole, so confine rejects any role carrying one of these:
administrator, manage_guild, manage_channels, manage_messages, kick_members, ban_members, moderate_members, manage_roles, manage_threads, view_audit_log, manage_webhooks, manage_expressions, mention_everyoneRoles above confine
Roles above confine
Confine can’t assign a role positioned higher than its own. Drag confine’s role above it in your server settings.
Roles above you
Roles above you
Unless you’re the server owner, you can’t set up a button for a role that sits at or above your highest role.
Managed and default roles
Managed and default roles
@everyone and roles tied to bots, boosts, or integrations can’t be used.Removing buttons
A single button
Run,buttonrole list first to find the number you want.
Every button on one message
Every button in the server
,buttonrole clear does the same thing.
Viewing what’s configured
,buttonrole list pages through every button role in the server with its message link, role, label, emoji, and style.