> ## 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. # Command Aliases > Create custom shortcuts for frequently used commands in your server ## Overview Command aliases allow you to create custom shortcuts for existing bot commands. This makes it easier for your community to use frequently accessed commands by creating shorter or more intuitive names. Aliases are server-specific and only work in the server where they're created. *** ## Commands Create a custom alias for an existing command. ```bash Syntax theme={null} ~alias add ``` ```bash Example theme={null} ~alias add hi help ~alias add w welcome ~alias add stats serverinfo ~alias add purge clear ``` **Parameters:** * **alias** — Your custom shortcut name (must be lowercase) * **actual\_command** — The real command to execute **What It Does:** * Creates a new command shortcut for your server * When users type the alias, it runs the actual command * Cannot override existing bot commands **Permissions:** Administrator Aliases cannot conflict with existing commands. Choose unique names that don't match any current bot commands. Remove a specific alias from your server. ```bash Syntax theme={null} ~alias remove ``` ```bash Example theme={null} ~alias remove hi ~alias remove w ~alias remove stats ``` **Parameters:** * **alias** — The alias to remove **What It Does:** * Deletes the specified alias * The original command remains unaffected * Users can no longer use the removed shortcut **Permissions:** Administrator View all aliases configured in your server. ```bash Syntax theme={null} ~alias list ``` ```bash Example theme={null} ~alias list ``` **What It Shows:** * All custom aliases in your server * The actual command each alias runs * Paginated display (5 aliases per page) * Total number of aliases **Permissions:** Administrator If you have many aliases, use the navigation buttons to browse through pages. Remove all aliases from your server. ```bash Syntax theme={null} ~alias clear ``` ```bash Example theme={null} ~alias clear ``` **What It Does:** * Deletes ALL aliases in your server * Cannot be undone * Leaves original commands intact This action is permanent and removes all aliases. Consider using `alias remove` for individual aliases instead. **Permissions:** Administrator *** ## How It Works Add a shortcut for a command you use frequently: ```bash theme={null} ~alias add w welcome ``` Now typing `~w` will run the `~welcome` command. Members can now use the alias just like the original command: ```bash theme={null} ~w add #general Welcome {user.mention}! ``` This is equivalent to: ```bash theme={null} ~welcome add #general Welcome {user.mention}! ``` View, remove, or modify aliases as needed: ```bash theme={null} # View all aliases ~alias list # Remove a specific alias ~alias remove w # Add a new alias ~alias add greet welcome ``` *** ## Permission Requirements No special permissions required beyond basic message reading and sending. Command Requirements: * **Administrator** — Required for all alias commands *** ## Troubleshooting **Problem:** "That alias conflicts with an existing command" **Solution:** * Choose a different alias name * Aliases cannot replace existing commands * Try a variation (e.g., `w` instead of `welcome`) * Check available commands with `~help` **Problem:** "You must have administrator permission to manage aliases" **Solution:** * Verify you have the Administrator permission * Check your role has sufficient privileges * Ask a server administrator for access **Problem:** "No alias named `X` exists in this server" **Solution:** * Check spelling of the alias * View all aliases with `~alias list` * Verify the alias was actually created * Aliases are case-insensitive **Problem:** "You must provide both an alias and a command" **Solution:** * Include both parameters: `~alias add ` * Correct: `~alias add w welcome` * Incorrect: `~alias add w` **Problem:** Using the alias doesn't run the command **Solutions:** * Verify alias exists with `~alias list` * Check you're using the correct prefix (\~) * Ensure the target command is valid * Try recreating the alias **Problem:** "No aliases have been set up in this server" **Solution:** * This is normal if you haven't created any aliases yet * Create your first alias: `~alias add hi help` * Aliases are server-specific *** ## Usage Examples ```bash theme={null} # Shorten common commands ~alias add w welcome ~alias add g goodbye ~alias add ar autorole ~alias add vm voicemaster # Now you can use: ~w add #general Welcome! ~g add #farewell Goodbye! ~ar add humans @Members ~vm setup ``` ```bash theme={null} # Create memorable aliases ~alias add greet welcome ~alias add farewell goodbye ~alias add roles autorole ~alias add voice voicemaster # Use more natural language: ~greet list ~farewell test #bye ~roles add humans @Member ~voice interface ``` ```bash theme={null} # Create aliases for your server's workflow ~alias add setup autosetup ~alias add info serverinfo ~alias add stats serverstats ~alias add mod moderation # Quick access: ~setup ~info ~stats ~mod kick @user Spam ``` ```bash theme={null} # View all aliases ~alias list # Remove unused aliases ~alias remove oldname ~alias remove unused # Update an alias (remove + add) ~alias remove w ~alias add w welcome # Clear all aliases ~alias clear ``` ```bash theme={null} # Help aliases ~alias add h help ~alias add commands help # Configuration aliases ~alias add config setup ~alias add settings config # Moderation aliases ~alias add b ban ~alias add k kick ~alias add m mute # Info aliases ~alias add ui userinfo ~alias add si serverinfo ``` *** ## Limitations **Important Restrictions** * Aliases cannot override existing bot commands * Aliases are server-specific (not global) * Only administrators can manage aliases * Aliases are case-insensitive * Cannot create aliases for aliases (no chaining) *** ## Related Features Automatically assign roles to new members when they join Learn about other server customization options