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

# Command Aliases

> Turn any misery command into your own custom shortcut.

## Overview

An alias is a nickname you assign to a command. Instead of typing the full thing every time, you define a shortcut once and misery expands it for you — optionally with parts of the command already filled in.

They're most useful for commands your staff run constantly with the same arguments. Rather than `,role @someone @Image Perms` a dozen times a day, you set up `,pic @someone` and you're done.

> [!NOTE]
>
> Creating and managing aliases requires the **Manage Server** permission.

## Creating an alias

```javascript Syntax theme={null}
,alias add (shortcut) (command)
```

```javascript Example theme={null}
,alias add deport ban
```

`,alias create` does the same thing.

### Rules for shortcuts

| Rule | Detail |
| - | - |
| Length | Between 1 and 64 characters |
| Opening character | Can't begin with `,` `'` `"` `<` or `@` |
| Conflicts | Can't match an existing misery command or one of its built-in aliases |
| Target | The command you're aliasing has to be real — typos get rejected |

## Filling in arguments ahead of time

The real value of aliases comes from baking arguments in. Anything typed after the alias gets slotted into numbered placeholders — `{0}` for the first word, `{1}` for the second, and upward from there.

```javascript theme={null}
,alias add hush timeout {0} 10m
,hush @financely
```

Running `,hush @financely` fires `,timeout @financely 10m`. The member comes from your input; the ten minutes is fixed.

> [!TIP]
>
> Numbering starts at zero, not one. `{0}` is always the first thing typed after your shortcut.

> [!NOTE]
>
> Run an alias without something it needs — `,hush` on its own — and misery shows that command's help instead of guessing.

### Example: a one-word image permission command

```javascript theme={null}
,alias add pic role {0} @Image Perms
,pic @financely
```

Your moderators never have to remember the role name — they just tag someone.

## Deleting aliases

### One at a time

```javascript Syntax theme={null}
,alias remove (shortcut)
```

```javascript Example theme={null}
,alias remove deport
```

### Every alias pointing at one command

```javascript Syntax theme={null}
,alias removeall (command)
```

```javascript Example theme={null}
,alias removeall ban
```

### Everything at once

`,alias reset` wipes every alias in the server after you confirm with a ✅ reaction.

## Checking what's configured

> **Looking up a single alias**
>
> Forgot what a shortcut actually does? Check it directly.
>
> ```javascript Syntax theme={null}
> ,alias view (shortcut)
> ```
>
> ```javascript Example theme={null}
> ,alias view deport
> ```

> **Listing everything**
>
> Run `,alias list` for a paginated view of every alias in the server alongside the command each one runs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.