Skip to content

Complete Modmail Command Reference

This document serves as a comprehensive reference for all available Modmail commands. It is divided into two main sections: commands that must be used inside a Modmail ticket channel, and commands that can be used anywhere on the server.

Part 1: Commands for Inside a Modmail Thread

Usage Context

These commands can only be used within an active Modmail ticket channel.

Command Aliases Description
!reply [message] !r Sends a standard reply. Your name and role will be shown.
!anonreply [message] !ar Sends an anonymous reply. Only your role (e.g., "Staff") will be shown.
!realreply [message] !rr Sends a reply that forcefully includes your username, even if the server defaults to anonymous replies.
Command Description Example
!close Closes the ticket immediately and notifies the user. !close
!close [time] Schedules the ticket to close after a set duration (e.g., 10m, 2h, 1d). This is canceled if anyone replies. !close 15m
!close -s Closes the ticket silently, without sending a notification to the user. !close -s
!close cancel Cancels a previously scheduled ticket closure. !close cancel
!move [category] Moves the ticket to a different category on the server. !move Resolved
!suspend Temporarily "pauses" the ticket. It acts as if closed and won't receive new messages until unsuspended. !suspend
!unsuspend Resumes a suspended ticket, allowing new messages again. !unsuspend
!alert Pings you in the channel when the user sends a new reply. !alert
!alert cancel Stops the alert notifications for the current ticket. !alert cancel
Command Description Example
!logs Displays a history of past Modmail tickets with this user. !logs
!loglink Generates a web link to the log of the current ticket. !loglink
!loglink -s Same as above, but the link only shows messages to/from the user (no internal staff chat). !loglink -s
!loglink -v Generates a verbose log link with extra details (message IDs, etc.), useful for reporting to Discord T&S. !loglink -v
!edit [num] [text] Edits one of your previous replies. The [num] is the message number shown in the ticket. !edit 3 I meant tomorrow.
!delete [num] Deletes one of your previous replies using its message number. !delete 2
Command Description Example
!block Blocks the user from creating new Modmail tickets. !block
!block [time] Temporarily blocks the user from Modmail for a set duration. !block 7d
!unblock Unblocks a user, allowing them to use Modmail again. !unblock
!note [text] Adds a private staff note to the user's profile. These are visible in future tickets. !note User was warned.
Command Description Example
!id Displays the user's unique Discord ID. !id
!role Shows the role currently displayed next to your name in replies. !role
!role [role name] Changes your displayed role for this specific ticket. You must have the role. !role Senior Mod
!role reset Resets your displayed role for this ticket back to your default. !role reset
!dm_channel_id Gets the unique ID of the DM channel between the bot and the user. !dm_channel_id
!message [num] Gets the message ID and link for a specific user reply in the ticket. !message 4

Part 2: Commands for Anywhere on the Server

Usage Context

These commands can be used in any channel on the staff server, not just inside a Modmail ticket. They typically require a User ID.

Command Description Example
!newthread [user ID] Manually opens a new Modmail ticket with a user. !newthread 1234567890
!logs [user ID] Retrieves the Modmail history for a specific user. !logs 1234567890
!block [user ID] Blocks a specific user from using Modmail. !block 1234567890
!block [user ID] [time] Temporarily blocks a specific user from Modmail. !block 1234567890 7d
!unblock [user ID] Unblocks a specific user from Modmail. !unblock 1234567890
!is_blocked [user ID] Checks if a user is currently blocked from Modmail. !is_blocked 1234567890
Command Description Example
!note [user ID] [text] Adds a private staff note to a specific user's profile. !note 1234567890 Warned.
!notes [user ID] Displays all staff notes for a specific user. !notes 1234567890
!delete_note [note ID] Deletes a specific note. You can get the [note ID] from the !notes command. !delete_note 5

Global Settings

These commands set your default display role across all tickets.

Command Description Example
!role Shows your current default display role for Modmail replies. !role
!role [role name] Sets a new default display role for yourself. !role Moderator
!role reset Resets your display role back to the server's default. !role reset
!version Displays the current version of the Modmail bot. !version