> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bloombot.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Command aliases

> Create your own shortcuts for Bloom's commands, including shortcuts that carry their own arguments.

An alias is your own name for a command. Use one to shorten a command you type often, or to save a whole command with its arguments behind a single word.

## The two kinds

**A shortcut for a command.** `!alias ban b` makes `!b @Someone Spamming` run `ban` with whatever you type after it.

**A saved command.** `!alias bc = purge bots 100` makes `!bc` run that entire command, arguments included, every time.

<ParamField path="alias <command> <shortcut>" type="Manage Server">
  Creates an alias, lists them, or removes them.

  * `!alias ban b` creates a shortcut for a command.
  * `!alias bc = purge bots 100` saves a full command behind one word.
  * `!alias list` shows both kinds, grouped.
  * `!alias remove b bc` removes several at once.
</ParamField>

<ParamField path="aliases [command]" type="Prefix command">
  Shows the aliases available in this server, both Bloom's built-in ones and yours. Add a command name to see just that command's. Aliases: `als`, `ali`. Any member can run it.
</ParamField>

## Rules

* A shortcut **cannot reuse an existing command's name**. Bloom refuses, because the real command would always win.
* Each shortcut can only be defined once. Remove it before redefining it.
* The command a full alias points at must exist when you create the alias.
* Aliases apply to your server only.

<Tip>
  Bloom already ships a short alias for most commands. Run `!aliases ban` before inventing your own to see what exists.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="My alias runs the wrong command">
    Bloom matches real command names before your aliases, so an alias that collides with a built-in name never fires. Run `!aliases` to see what is taken and pick a different word.
  </Accordion>

  <Accordion title="Bloom says the shortcut already exists">
    That word is already an alias here. Remove it first with `!alias remove <word>`, then create it again.
  </Accordion>

  <Accordion title="Nothing happens when I use my alias">
    Confirm it is listed in `!alias list`, and that you can run the underlying command yourself. An alias never grants access you do not already have.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Using prefix commands" icon="terminal" href="/getting-started/commands">
    How Bloom reads what you type.
  </Card>

  <Card title="Prefix and appearance" icon="palette" href="/configuration/appearance">
    Change the prefix your aliases start with.
  </Card>

  <Card title="Commands not responding" icon="circle-question" href="/troubleshooting/commands">
    When a command or alias does nothing at all.
  </Card>

  <Card title="Full command list" icon="list" href="https://bloombot.cloud/commands">
    Every command you can alias.
  </Card>
</CardGroup>