Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt

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

​
Overview

The role management system provides powerful tools for creating, editing, and managing Discord roles. From simple role assignment to bulk operations and detailed customization, the r command handles all your role management needs.
All role commands support flexible syntax - you can specify roles by mention, ID, or name.

​
Commands

Add or remove a role from a user.
~r <user> <role>
What It Does:
  • If user has the role, removes it
  • If user does not have the role, adds it
  • Automatic toggle behavior
Permissions: Manage Roles
Create a new role with optional position and color.
~r create <name> [position] [color]
Parameters:
  • name — Role name (required)
  • position — Role position in hierarchy (optional)
  • color — Hex code (optional)
Aliases: r c
Permissions: Manage Roles
Delete a role by mention, ID, or name.
~r delete <role>
What It Does:
  • If multiple roles match, shows selection menu
  • Navigate with arrow buttons
  • Confirm deletion with Delete button
Aliases: r del, r d
Permissions: Manage Roles
Update role name, color, and position interactively.
~r edit <role>
Interactive Prompts:
  1. New Name? (reply “none” to skip)
  2. New Color? (reply “none” to skip)
  3. New Position? (reply “none” to skip)
Aliases: r update, r e, r u
Permissions: Manage Roles
Change a role’s color. Supports solid colors, gradients, and holographic styling.
~r color <role> <color>
~r color <color> <role>
~r color <role> <color1> <color2>
~r color <role> holo
Color Modes:
  • Solid — Single color name or hex code applied to the role
  • Gradient — Two colors create a gradient effect (requires Enhanced Role Styles)
  • Holographic — Special animated holographic style (requires Enhanced Role Styles)
Flexible Syntax:
  • Role first: r color @Admin red
  • Color first: r color red @Admin
Color Formats:
  • Color names: red, blue, purple, green, yellow, orange, pink, etc.
  • Hex codes: #ff0000, 3498db, etc.
Aliases: r colour
Permissions: Manage Roles
Gradient and holographic modes require the server to have Enhanced Role Styles enabled.
Rename a role to a new name.
~r rename <role> <new_name>
~r rename <new_name> <role>
Flexible Syntax:
  • Role first: r rename @OldName NewName
  • Name first: r rename NewName @OldName
Aliases: r name, r rn
Permissions: Manage Roles
Set or remove a role icon from an emoji, URL, or image attachment.
~r icon <role> <emoji/url>
~r icon <emoji/url> <role>
~r icon remove <role>
Supported Input:
  • Unicode emojis
  • Custom Discord emojis
  • Image URLs
  • Image attachments (attach an image directly to the message)
Flexible Syntax:
  • Role first or icon first
Aliases: r i
Permissions: Manage Roles
Get detailed information about a role. You can also pass a user mention or ID to view their highest role.
~r info <role>
~r info <user>
Information Shown:
  • Role name and ID
  • Member count
  • Position in hierarchy
  • Color (including gradient and holographic display)
  • Mentionable status
  • Hoisted status
  • Managed status
  • Creation date
  • Permissions list
Aliases: r information
Permissions: None (view only)
Add or remove a role from all human users.
~r humans <role>
Smart Toggle:
  • If more than 50% of humans have the role, removes from all
  • If less than 50% of humans have the role, adds to all
Process:
  • Shows progress message
  • Processes approximately 10 members per second
  • Reports success and failure count
Aliases: r human
Permissions: Manage Roles
This is a bulk operation and may take time for large servers.
Add or remove a role from all bots.
~r bots <role>
Smart Toggle:
  • If more than 50% of bots have the role, removes from all
  • If less than 50% of bots have the role, adds to all
Process:
  • Shows progress message
  • Processes approximately 10 bots per second
  • Reports success and failure count
Aliases: r bot
Permissions: Manage Roles

​
Role Finding

The system intelligently finds roles using multiple methods:
  1. Mention — Most reliable method
  2. ID — Use the role’s unique ID
  3. Exact Name — Case-insensitive exact match
  4. Partial Name — If only one role contains the text
If multiple roles match, you’ll get a selection menu to choose the correct one.

​
Permission Requirements

Bot Permissions

The bot needs:
  • Manage Roles
  • Bot’s role must be higher than roles it manages

User Permissions

Command Requirements:
  • Manage Roles — For most commands
  • Your highest role must be above the role you’re managing
  • Server owner bypasses hierarchy checks

​
Aliases

The role command has a short and convenient alias:

r

Main alias for all role commands

​
Usage Examples

# Toggle role on or off for a user
~r @John Member
~r @User VIP

# Create a simple role
~r create Supporter

# Delete a role
~r delete @OldRole

# Get role info
~r info @Admin

Autorole

Automatically assign roles to new members

Server Settings

Manage other aspects of your server configuration