> ## 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 Permissions (Permit) > Grant specific roles permission to use restricted commands ## Overview The permit system allows you to grant specific roles permission to use commands that would normally require certain permissions. This creates a flexible permission structure where you can delegate command access without granting full Discord permissions. Permits work alongside Discord permissions - they grant additional access, not replace existing permission requirements. *** ## Commands Allow a role to use a specific command. ```bash Syntax theme={null} ~permit add ``` ```bash Example theme={null} ~permit add @Moderators ban ~permit add @Helpers kick ~permit add Staff warn ~rolepermit add @Trusted purge ``` **Parameters:** * **role** — Role mention, ID, or name * **command** — Command name to grant access to **What It Does:** * Grants the role permission to use the command * Works with role mentions, IDs, or names * Multiple commands can be added per role **Aliases:** `rolepermit add`, `cmdpermit add`\ **Permissions:** Administrator Remove a role's permission for a specific command. ```bash Syntax theme={null} ~permit remove ``` ```bash Example theme={null} ~permit remove @Moderators ban ~permit remove @Helpers kick ~permit remove Staff warn ~rolepermit remove @Trusted purge ``` **Parameters:** * **role** — Role mention, ID, or name * **command** — Command name to revoke access from **What It Does:** * Removes the role's permission for the command * Role can no longer use that command * Other permits for the role remain intact **Aliases:** `rolepermit remove`, `cmdpermit remove`\ **Permissions:** Administrator View all role permissions in your server. ```bash Syntax theme={null} ~permit list ``` ```bash Example theme={null} ~permit list ~rolepermit list ~cmdpermit list ``` **What It Shows:** * All roles with command permissions * Which commands each role can use * Paginated display (10 entries per page) * Total count of permits **Aliases:** `rolepermit list`, `cmdpermit list`\ **Permissions:** Administrator Clear all role permissions in your server. ```bash Syntax theme={null} ~permit clear ``` ```bash Example theme={null} ~permit clear ~rolepermit clear ~cmdpermit clear ``` **What It Does:** * Removes ALL role permits from the server * Shows count of cleared roles * Cannot be undone This removes all permit configurations. Use `permit remove` for individual permissions. **Aliases:** `rolepermit clear`, `cmdpermit clear`\ **Permissions:** Administrator *** ## How It Works Add permissions for roles to use specific commands: ```bash theme={null} ~permit add @Moderators ban ~permit add @Moderators kick ~permit add @Helpers warn ``` Users with those roles can now use the commands: * Members with @Moderators can use ban and kick * Members with @Helpers can use warn * Permissions stack with Discord permissions View, remove, or clear permissions as needed: ```bash theme={null} # View all permits ~permit list # Remove specific permit ~permit remove @Helpers warn # Clear everything ~permit clear ``` *** ## Role Resolution The system accepts roles in multiple formats: 1. **Mention** — `@Moderators` (most reliable) 2. **Role ID** — `123456789012345678` 3. **Role Name** — `Moderators` (case-insensitive) If multiple roles have similar names, use mention or ID for accuracy. *** ## Permission Requirements No special permissions required beyond basic message reading and sending. Command Requirements: * **Administrator** — Required for all permit commands *** ## Aliases All permit commands support multiple aliases: Main command Role-focused alias Command-focused alias *** ## Usage Examples ```bash theme={null} # Grant moderator commands ~permit add @Moderators ban ~permit add @Moderators kick ~permit add @Moderators mute ~permit add @Moderators warn # Grant helper commands ~permit add @Helpers warn ~permit add @Helpers mute # View configuration ~permit list ``` ```bash theme={null} # Senior staff gets full access ~permit add @Senior ban ~permit add @Senior kick ~permit add @Senior mute # Junior staff gets limited access ~permit add @Junior warn ~permit add @Junior mute # Trial staff gets minimal access ~permit add @Trial warn ``` ```bash theme={null} # Event managers ~permit add @EventManager announce ~permit add @EventManager giveaway # Support team ~permit add @Support ticket ~permit add @Support close # Content moderators ~permit add @ContentMod purge ~permit add @ContentMod warn ``` ```bash theme={null} # View all permits ~permit list # Remove specific permission ~permit remove @Helpers mute # Clear all permits ~permit clear ``` ```bash theme={null} # Add using role ID ~permit add 123456789012345678 ban # Add using role name ~permit add Moderators kick # Add using mention ~permit add @Staff warn ``` *** ## Common Use Cases ```bash theme={null} # Give mods ban command without Ban Members permission ~permit add @Moderators ban # Give helpers warn without Manage Messages ~permit add @Helpers warn ``` Allows command access without granting Discord permissions. ```bash theme={null} # Senior staff - full access ~permit add @Senior ban ~permit add @Senior kick ~permit add @Senior mute # Junior staff - limited access ~permit add @Junior warn ~permit add @Junior timeout ``` Different permission levels for different staff tiers. ```bash theme={null} # Event coordinators ~permit add @Events giveaway ~permit add @Events announce # Support team ~permit add @Support ticket ``` Grant access to specific features based on role purpose. ```bash theme={null} # Grant temporary access ~permit add @Trial warn # Remove after trial period ~permit remove @Trial warn ``` Easy to add and remove as needed. *** ## Important Notes **Permission Stacking** * Permits grant ADDITIONAL access * They do not override Discord permissions * Bot still needs required permissions * Users still need basic channel access **Best Practices** * Use specific role names to avoid confusion * Document which roles have which permits * Review permits regularly with `permit list` * Remove permits when roles change *** ## Related Features Control which commands are available server-wide Create and manage server roles