Skip to content

Moderation Commands

Current moderation command groups are:

  • /mod — core moderation actions
  • /cases — case management, notes, and moderator tools

Permissions

Most moderation commands require either:

  • Manage Server permission, or
  • Explicit moderation permission override via /permissions grant command_group:moderation ...

Role assignment (/role add, /role remove — see Admin Commands) uses the roles command category, same as before.

/mod Commands

Command Description
/mod kick <member> [reason] Kick a member
/mod ban <user> [reason] [delete_days] Ban by mention or user ID string
/mod softban <user> [reason] Ban + message cleanup + immediate unban
/mod unban <user_id> [reason] Unban by numeric user ID
/mod timeout <member> <duration> [reason] Timeout in minutes (1 to 40320)
/mod untimeout <member> [reason] Remove timeout
/mod tempban <member> <duration> [reason] [delete_days] Temporary ban with automatic expiry
/mod warn <member> <reason> Add warning
/mod warnings <member> List active warnings
/mod clearwarn <warning_id> Clear one warning
/mod clearwarns <member> Clear all warnings for member
/mod purge <count> [user] [contains] Bulk delete messages (1-500)
/mod lock [channel] [reason] Lock a channel (revoke Send Messages for @everyone)
/mod unlock [channel] Unlock a previously locked channel
/mod slowmode <seconds> [channel] Set slowmode (0 to 21600)
/mod massban <user_ids> [reason] [delete_days] Ban multiple users by ID (for raids)
/mod clean [count] Remove bot messages from the channel
/mod snipe Show the last deleted message in this channel
/mod import <file> Import moderation history from a JSON file

For a server-wide emergency, /server lockdown locks every text channel at once, and /server unlockdown restores them.

/cases Commands

Command Description
/cases view <case_number> View one case
/cases list <user> [limit] List recent cases for a user
/cases reason <case_number> <new_reason> Update case reason
/cases stats [moderator] Moderation statistics
/cases duration <case_number> <duration> Change timed punishment duration
/cases history <user> Export moderation history JSON
/cases note <user> <note> Add private moderator note
/cases notes <user> View moderator notes
/cases removenote <note_id> Remove a note
/cases clearnotes <user> Clear all notes for user
/cases report ... Submit a moderator report

Important Notes

  • There is no /mod-config or /mod-debug command group — moderation configuration (warning thresholds, automod policy) lives on the Moderation dashboard page, opened with /dashboard.
  • Moderation actions create case records that can be reviewed through /cases.

Common Examples

/mod warn member:@User reason:"Inappropriate language"
/mod timeout member:@User duration:60 reason:"Cooldown"
/mod purge count:50 contains:"discord.gg"
/cases view case_number:42
/cases list user:@User limit:10