---
# System prepended metadata

title: Snippets

---

## Inside a Modmail thread
These commands can only be used inside a Modmail thread's channel on the inbox server.

### `?reply <text>` / `?r <text>`
Send a reply to the user.

**Example:** `?r How can I help you?`

### `?anonreply <text>` / `?ar <text>`
Send an anonymous reply to the user. Anonymous replies only show the moderator's role in the reply.

**Example:** `?ar Please only use Modmail for serious messages`

### `?close`
Close the Modmail thread.

### `?close <time>`
Close the Modmail thread after a timer. Sending a message to the user or receiving a message from the user will cancel scheduled closing.

**Example:** `?close 15m`

### `?close -s` / `?close -s <time>`
Close the Modmail thread without notifying the user that it was closed.

### `?close cancel`
Cancel a timed close.

### `?logs`
List previous Modmail logs with the user.

### `?block`
Block the user from using Modmail.

### `?block <time>`
Block the user from using Modmail for a specified time.

**Example:** `?block 7d`

### `?unblock`
Unblock the user, allowing them to use Modmail again.

### `?move <category>`
Move the Modmail thread to a different category.
Requires `allowMove` to be enabled in the bot's settings.

### `?suspend`
Suspend the thread.
The thread will act as closed and will not receive any messages until unsuspended via `?unsuspend`.

### `?unsuspend`
Unsuspend the thread. See `?suspend` above.

### `?alert`
Pings you when the thread gets a new reply.

### `?alert cancel`
Cancel the ping set by `?alert`.

### `?edit <number> <new text>`
Edit your own previous reply sent with `?reply`.  
`<number>` is the message number shown in front of staff replies in the thread channel.

### `?delete <number>`
Delete your own previous reply sent with `?reply`.  
`<number>` is the message number shown in front of staff replies in the thread channel.

### `?role`
View your display role for the thread - the role that is shown in front of your name in your replies

### `?role reset`
Reset your display role for the thread to the default

### `?role <role name>`
Change your display role for the thread to any role you currently have

### `?id`
Prints the user's ID.

### `?note <text>`
Add a note for the user

### `?notes <userID>`
Show all notes for the user

### `?delete_note <noteID>`
Delete the specified note. The note ID is shown when running `?notes`.

### `?dm_channel_id`
Prints the ID of the current DM channel with the user

### `?message <number>`
Shows the DM channel ID, DM message ID, and message link of the specified user reply.
`<number>` is the message number shown in front of staff replies in the thread channel.

## Anywhere on the inbox server
These commands can be used anywhere on the inbox server, even outside Modmail threads.

### `?newthread <userID>`
Open a Modmail thread with a user.

**Example:** `?newthread 106391128718245888`

### `?logs <userID>`
List previous Modmail logs with the specified user.

**Example:** `?logs 106391128718245888`

### `?block <userID>`
Block the specified user from Modmail.

**Example:** `?block 106391128718245888`

### `?block <userID> <time>`
Block the specified user from Modmail for a specified time.

**Example:** `?block 106391128718245888 7d`

### `?unblock <userID>`
Unblock the specified user, allowing them to use Modmail again.

**Example:** `?unblock 106391128718245888`

### `?is_blocked <userID>`
Check if the specified user is blocked.

**Example:** `?is_blocked 106391128718245888`

### `?role`
(Outside a modmail thread) View your default display role - the role that is shown in front of your name in your replies

### `?role reset`
(Outside a modmail thread) Reset your default display role

### `?role <role name>`
(Outside a modmail thread) Change your default display role to any role you currently have

### `?note <userID> <text>`
Add a note for the specified user

### `?notes <userID>`
Show all notes for the specified user

### `?delete_note <noteID>`
Delete the specified note. The note ID is shown when running `?notes`.

# Snippets
Snippets, sometimes also called "canned messages" or "tags", are commonly used messages you can send in Modmail threads with just 1 command.

## View available snippets
### `!snippets` / `!s <shortcut>`

To view all available snippets, use the command `!snippets`.

To view a specific snippet's text, use the command `!s <shortcut>`.
For example, to view the text of a snippet called "hi", run `!s hi`.

## Creating snippets
### `!s <shortcut> <text>`

#### Example
To create a snippet called "hi" with the text "Hello, how can we help you?", use the following command:

`!s hi Hello, how can we help you?` 

## Using snippets
### `!!shortcut` / `!!!shortcut`
Inside a Modmail thread, use `!!shortcut` to send a snippet to the user, replacing `shortcut` with the snippet's name.

To send a snippet anonymously, use `!!!shortcut`.

*The prefixes `!!` and `!!!` can be changed with the bot options `snippetPrefix` and `snippetPrefixAnon` respectively.*

#### Example
To send a snippet called "hi", use the following command:

`!!hi`

To send that same snippet anonymously, use the following command:

`!!!hi`

## Editing snippets
### `!edit_snippet <shortcut> <text>` / `!es <shortcut> <text>`

#### Example
To edit a snippet called "hi" to say "Hello, how are you?", use the following command:

`!es hi Hello, how are you?`

## Deleting snippets
### `!delete_snippet <shortcut>` / `!ds <shortcut>`

#### Example
To delete a snippet called "hi", use the following command:

`!ds hi`