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

alias add

Create a custom alias for an existing command.

Syntax

~alias add <alias> <actual_command>

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.

alias remove

Remove a specific alias from your server.

Syntax

~alias remove <alias>

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

alias list

View all aliases configured in your server.

Syntax

~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.

alias clear

Remove all aliases from your server.

Syntax

~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

1. Create an Alias

   Add a shortcut for a command you use frequently:

   ~alias add w welcome
   

   Now typing ~w will run the ~welcome command.

2. Use Your Alias

   Members can now use the alias just like the original command:

   ~w add #general Welcome {user.mention}!
   

   This is equivalent to:

   ~welcome add #general Welcome {user.mention}!
   
3. Manage Aliases

   View, remove, or modify aliases as needed:

   # View all aliases
   ~alias list
   
   # Remove a specific alias
   ~alias remove w
   
   # Add a new alias
   ~alias add greet welcome
   

---

Permission Requirements

Bot Permissions

No special permissions required beyond basic message reading and sending.

User Permissions

Command Requirements:

• Administrator — Required for all alias commands

---

Troubleshooting

Command conflict error

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

Permission denied

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

Alias not found

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

Missing arguments

Problem: “You must provide both an alias and a command”

Solution:

• Include both parameters: ~alias add <alias> <command>
• Correct: ~alias add w welcome
• Incorrect: ~alias add w

Alias doesn't work

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

No aliases found

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

Basic Shortcuts

# 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

Intuitive Names

# 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

Server-Specific

# 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

Management

# 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

Common Patterns

# 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

Autorole

Automatically assign roles to new members when they join

Server Configuration

Learn about other server customization options