Moderator Commands

Day-to-day moderation tools for server moderators.

Quick cheatsheet

The essentials every moderator should know:

Need to…	Command	Jump
Mass delete messages	`/clear` · `;clear` · `;purge`	Clear
Silence/mute someone	`/mute` · `;mute`	Mute
Remove from server	`/kick` · `;kick`	Kick
Ban someone	`/ban` · `;ban`	Ban
Change a nickname	`/nickname`	Nickname
Issue a warning	`/warnings add` · `;warn`	Issue a warning
Look up / recent warnings	`/warnings lookup user` · `/warnings recent` · `;warnings`	Look up warnings
Remove one warning	`/warnings remove specific` · `;delwarning`	Remove a warning
Add a note to a warning	`/warnings add_note` · `;warnnote`	Warning notes
Check automod strikes	`/automod-member status`	Automod member status

Not a complete list of all commands. All commands are listed below.

Clear

Quickly deletes a specified number of messages from the current channel. The Slash command can also clear everything down to a target message ID while keeping that target message, as long as it is no older than 3 days. The prefix command keeps the existing amount-based syntax.

Usage:

/clear [amount to clear] [optional: user] [optional: clear_until_message]

;clear [amount to clear] [optional: user]

;purge [amount to clear] [optional: user]

Example:

/clear 5
/clear clear_until_message:1413565360911769600
;clear 5
;purge 100 @Wumpus

If clear_until_message is provided, /clear ignores amount and deletes messages newer than that message ID while keeping the target message itself. The target message must be from the last 3 days.

Required Role: Moderator

Pro Tip

Use this to quickly clean up spam or unwanted messages without manual deletion.

Mute

Temporarily mutes a member, preventing them from speaking in voice/text channels. Works as both a Slash command and a traditional prefix command.

Usage:

/mute [user] [optional: reason] [optional: time] [optional: send_dm]

;mute [user] [optional: reason] [-t time] [--timeout yes/no] [--dm yes/no]

Example:

/mute @Wumpus Advertising 1day Yes
;mute @Wumpus Advertising -t 1d --dm no
;mute @Wumpus (unmutes if already muted)

Notes:

If no time is specified, the user remains muted until manually unmuted
Running the command again on a muted user will unmute them
Set send_dm to Yes or use --dm yes to notify the user via DM

Required Role: Moderator

Kick

Removes a member from the server without banning them. Works as both a Slash command and a traditional prefix command.

Usage:

/kick [user] [reason]

;kick [user] [optional: reason]

Example:

/kick @Wumpus Spamming chat
;kick @Wumpus Spamming chat

Required Role: Moderator

Warning

The user can rejoin the server immediately after being kicked.

Ban

Permanently or temporarily removes a member from the server and prevents them from rejoining. Works as both a Slash command and a traditional prefix command.

Usage:

/ban [user] [reason] [optional: days to delete messages] [optional: ban duration]

;ban [user/user_id] [optional: reason] [-t duration] [-d delete_days]

Example:

/ban @Wumpus Repeated violations 7 permanent
;ban @Wumpus Repeated violations -t 7d -d 1

Parameters:

days to delete messages / -d - Number of days of messages to delete (0-7)
ban duration / -t - How long the ban lasts (leave empty or use permanent for permanent bans)

Notes:

Unbanning is admin-only. Running /ban on an already banned user will not unban them unless you have the Admin role, use /unban as an admin instead.

Required Role: Moderator

Caution

This action is permanent (unless an admin unbans the user) and cannot be easily undone. Use caution.

Nickname

Changes a member's server nickname.

Usage:

/nickname [user] [nickname] [optional: reason] [optional: dm_user]

Example:

/nickname @Wumpus Wumpus Junior Nickname violation Yes

Parameters:

user - The member whose nickname you want to change
nickname - The new nickname (max 32 chars). Enter clear to reset the nickname to their default username.
reason - The reason for the nickname change (defaults to "No reason specified")
dm_user - Whether to send a DM notification to the user (True/False, defaults to False)

Required Role: Trial Moderator

Warning System

Manage member warnings and infractions. Where a prefix form exists, it is documented with its slash counterpart.

Issue a warning

Issues a warning to one or more members.

Usage (slash):

/warnings add [member] [optional: dm_member: yes/no] [optional: optional_user_ids]

Usage (prefix):

;warn [member(s) or user_id(s)] [optional: -dm yes/no] [reason]

Example:

/warnings add @Wumpus yes "123456789012345678, 234567890123456789"
;warn @Wumpus -dm no Spamming chat
;warn 123456789012345678, 234567890123456789 Mass advertisement

Notes:

Slash: After running, Discord provides a text box to enter the warning reason. optional_user_ids accepts space or comma-separated User IDs for multi-user warns. DM defaults to Yes.
Prefix: Supports multiple space or comma-separated mentions and User IDs. Use -dm for DM control (defaults to yes). Accepted values (case-insensitive): Yes, No, True, False, 1, 2.

Required Role: Moderator

Look up warnings

Check a user's warning history, or list recent server warnings.

Usage (slash):

/warnings lookup user [user] [optional: include_auto]
/warnings recent
/warnings lookup id [id]

Usage (prefix):

;warnings [optional: member] [optional: -auto]

Example:

/warnings lookup user @Wumpus yes
/warnings recent
/warnings lookup id 1234567
;warnings @Wumpus -auto
;warnings

Notes:

Slash outputs are sent to the moderator log channel.
include_auto / -auto (also --auto, --include_auto) includes automod infractions (defaults to no).
Prefix: With a member, shows that user's warnings; with no member, lists recent server warnings.

Required Role: Moderator

Remove a warning

Removes a specific warning from a user's record by ID.

Usage (slash):

/warnings remove specific [id] [optional: reason] [optional: dm_member]

Usage (prefix):

;delwarning [warning_id] [optional: -dm yes/no] [optional: reason]

Example:

/warnings remove specific 1234567 "Appeal accepted" yes
;delwarning 1234567 -dm no Appeal accepted

Notes:

Optionally DM the member about the removal. Slash defaults to No; prefix -dm defaults to yes. Accepted -dm values (case-insensitive): Yes, No, True, False, 1, 2.

Required Role: Moderator

Caution

Use this carefully, removing warnings should only be done for errors or appeals.

Admin-only wipe

To clear a user's entire warning history, use /fullpardon Administrator → Full Pardon.

Warning notes

Add or remove infraction notes on a warning.

Usage (slash):

/warnings add_note [text] [optional: id]
/warnings remove_note [id] [update_id]

Usage (prefix):

;warnnote -id [warning_id] [text]
;warnnote [text]

Prefix aliases for adding a note: ;addnote, ;warningnote, ;note, ;update.

Example:

/warnings add_note "User is extremely argumentative about this" 1234567
/warnings remove_note 1234567 827163
;warnnote -id 1234567 User was toxic
;warnnote User was toxic

Notes:

If Warning ID is omitted when adding a note, the bot defaults to your last given infraction if it is recent (within 1 hour), or the last warning in the server (prefix).

Required Role: Moderator

Send warning DM

Manually sends a DM to the member for a specific warning ID if it was previously missed.

Usage:

/warnings send_dm [id]

Example:

/warnings send_dm 1234567

Required Role: Moderator

Automod member status

View a user's current filter trigger counts and active punishment scaling level.

Usage:

/automod-member status [user]

Required Role: Moderator

Automod member reset

Clears all active violation counts and resets a user's scaling level to 1 for all rules.

Usage:

/automod-member reset [user]

Required Role: Moderator