Roles

Reaction roles, button roles, booster roles, and sticky roles — flexible self-service role management.

The Roles module provides multiple ways for members to get roles and for admins to manage role assignment. From classic reaction roles to persistent sticky roles, Slipz covers every role management pattern.

Quick Reference

Command	Description	Permission	Cooldown
`.reactionrole`	Manage reaction-based role assignment	Admin	3s
`.buttonrole`	Manage button-based role assignment	Admin	3s
`.boosterrole`	Custom roles for server boosters	Varies	5s
`.stickyroles`	Reassign roles when members rejoin	Admin	3s

Reaction Roles

Let members assign themselves roles by reacting to a message with an emoji.

Setup

Create a reaction role panel:

.reactionrole create #self-roles Pick your roles!

Add role-emoji pairs:

.reactionrole add <messageId> @Gaming :video_game:
.reactionrole add <messageId> @Music :musical_note:

Subcommands

.reactionrole create <#channel> <text>       — Create a new reaction role panel
.reactionrole add <messageId> <@role> <emoji> — Add a role to a panel
.reactionrole remove <messageId> <emoji>      — Remove a role from a panel
.reactionrole mode <messageId> <mode>         — Set the panel's mode
.reactionrole list                            — List all reaction role panels
.reactionrole delete <messageId>              — Delete a panel entirely

Aliases: rr Permission: Admin

Modes

Reaction role panels support 8 different behavior modes:

Mode	Behavior
`normal`	Members can pick any number of roles
`unique`	Members can only pick one role at a time
`verify`	Reacting gives the role, but unreacting does not remove it
`drop`	Reacting removes the role (useful for opt-out)
`binding`	Once a role is picked, it cannot be removed by unreacting
`reversed`	Removing a reaction gives the role, adding removes it
`locked`	No reactions are processed (panel is frozen)
`temporary`	Role is removed when the member leaves the server

Examples:

.reactionrole create #roles Choose your color:
.reactionrole add 123456789012345678 @Red :red_circle:
.reactionrole add 123456789012345678 @Blue :blue_circle:
.reactionrole mode 123456789012345678 unique

Button Roles

Let members assign themselves roles by clicking buttons under a message. Buttons are more visible and user-friendly than reactions.

Setup

Create a button role panel:

.buttonrole create #self-roles Pick your roles!

Add role-button pairs:

.buttonrole add <messageId> @Gaming "Gamer" green
.buttonrole add <messageId> @Artist "Artist" blue

Subcommands

.buttonrole create <#channel> <text>                      — Create a new panel
.buttonrole add <messageId> <@role> <label> [style]       — Add a button
.buttonrole remove <messageId> <@role>                     — Remove a button
.buttonrole list                                           — List all panels
.buttonrole delete <messageId>                             — Delete a panel

Aliases: br Permission: Admin

Button Styles

Style	Appearance
`primary` / `blue`	Blue button
`secondary` / `grey`	Grey button
`success` / `green`	Green button
`danger` / `red`	Red button

Examples:

.buttonrole create #roles Click to get roles:
.buttonrole add 123456789012345678 @Announcements "Announcements" blue
.buttonrole add 123456789012345678 @Events "Events" green
.buttonrole add 123456789012345678 @NSFW "18+" red

Booster Roles

Give server boosters the ability to create and customize their own personal role with a custom name, color, and icon.

User Commands (Boosters Only)

.boosterrole color <hex>        — Set your custom role color
.boosterrole name <text>        — Set your custom role name
.boosterrole icon <emoji|url>   — Set your custom role icon
.boosterrole delete             — Delete your custom role

Admin Commands

.boosterrole setup               — Set up the booster role system
.boosterrole base <@role>        — Set the base role (position reference)
.boosterrole award <@member>     — Manually award a booster role
.boosterrole list                — List all custom booster roles
.boosterrole cleanup             — Remove orphan roles from members who stopped boosting
.boosterrole enable              — Enable the booster role system
.boosterrole disable             — Disable the booster role system
.boosterrole settings            — View current settings

Aliases: bra, br-role, boostcolor Cooldown: 5 seconds

Examples:

.boosterrole color #ff69b4
.boosterrole name VIP Alex
.boosterrole icon :sparkles:

Custom booster roles are created above the base role in the hierarchy. The base role determines where in the role list custom roles appear. Set it with .boosterrole base @role.

Sticky Roles

When enabled, sticky roles remember the roles a member has when they leave. If they rejoin, their roles are automatically restored.

Subcommands

.stickyroles enable              — Enable sticky roles
.stickyroles disable             — Disable sticky roles
.stickyroles status              — Show if sticky roles are enabled
.stickyroles list <@user>        — Show saved roles for a user
.stickyroles clear <@user>       — Clear saved roles for a user

Aliases: sr, sticky Permission: Admin

Examples:

.stickyroles enable
.stickyroles list @Alex
.stickyroles clear @Alex

Sticky roles are stored in the database when a member leaves. When they rejoin, the bot attempts to re-assign all stored roles. Roles that no longer exist or that the bot cannot assign (above its highest role) are silently skipped.

Roles

On this page