> ## 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. # Role Management > Comprehensive role creation, editing, and assignment system ## 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. ```bash Syntax theme={null} ~r ``` ```bash Example theme={null} ~r @John Admin ~r @User 123456789 ~r @Member Moderator ``` **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. ```bash Syntax theme={null} ~r create [position] [color] ``` ```bash Example theme={null} ~r create VIP ~r create Moderator 5 ~r create Admin #ff0000 ~r create Staff 10 #3498db ``` **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. ```bash Syntax theme={null} ~r delete ``` ```bash Example theme={null} ~r delete @OldRole ~r delete 123456789 ~r delete Inactive 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. ```bash Syntax theme={null} ~r edit ``` ```bash Example theme={null} ~r edit @Admin ~r edit Moderator ~r edit 123456789 ``` **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. ```bash Syntax theme={null} ~r color ~r color ~r color ~r color holo ``` ```bash Example theme={null} ~r color @Admin red ~r color blue Moderator ~r color @VIP #ff0000 #9b59b6 ~r color @Staff 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. ```bash Syntax theme={null} ~r rename ~r rename ``` ```bash Example theme={null} ~r rename @OldName NewName ~r rename SuperAdmin @Admin ~r rename HeadMod Moderator ``` **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. ```bash Syntax theme={null} ~r icon ~r icon ~r icon remove ``` ```bash Example theme={null} ~r icon @Admin 👑 ~r icon 🛡️ Moderator ~r icon @VIP https://example.com/icon.png ~r icon remove @Admin ``` **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. ```bash Syntax theme={null} ~r info ~r info ``` ```bash Example theme={null} ~r info @Admin ~r info Moderator ~r info 123456789 ~r info @John ``` **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. ```bash Syntax theme={null} ~r humans ``` ```bash Example theme={null} ~r humans @Members ~r humans Verified ~r humans Community ``` **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. ```bash Syntax theme={null} ~r bots ``` ```bash Example theme={null} ~r bots @Bot ~r bots Utility Bots ~r bots Music Bots ``` **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 The bot needs: * Manage Roles * Bot's role must be higher than roles it manages 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: Main alias for all role commands *** ## Usage Examples ```bash theme={null} # 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 ``` ```bash theme={null} # Basic role ~r create Member # Role with color ~r create VIP #ff69b4 ~r create Donator #e91e8c # Role with position ~r create Moderator 5 # Role with both ~r create Admin 10 #ff0000 ``` ```bash theme={null} # Solid color ~r color @Admin blue ~r color green Moderator # Gradient color ~r color @VIP #ff0000 #9b59b6 # Holographic ~r color @Staff holo # Rename role ~r rename @OldName NewName # Set icon ~r icon @Admin 👑 ~r icon 🛡️ Moderator # Remove icon ~r icon remove @Admin # Edit everything interactively ~r edit @Admin ``` ```bash theme={null} # Give role to all humans ~r humans @Members # Give role to all bots ~r bots @Bot # Remove role from all humans ~r humans @Temporary # Remove role from all bots ~r bots @Testing ``` ```bash theme={null} # Multiple ways to specify roles ~r info @Admin ~r info 123456789 ~r info Admin # Get info via user mention ~r info @John # Flexible color syntax ~r color red @Admin ~r color @Admin red # Flexible rename syntax ~r rename NewName @OldName ~r rename @OldName NewName # Flexible icon syntax ~r icon 👑 @Admin ~r icon @Admin 👑 # Icon via attachment # (attach image to the message) ~r icon @Admin ``` *** ## Related Features Automatically assign roles to new members Manage other aspects of your server configuration