Skip to content

Moderation Commands

Current moderation command groups are:

  • /mod - Core moderation actions
  • /cases - Case management, notes, and moderator tools
  • /mod-debug - Runtime diagnostics and dry-run checks

Permissions

Most moderation commands require either:

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

Role-assignment commands (/mod addrole, /mod removerole) use the roles command category.

/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 lockdown [channel] [reason] Lock channel for @everyone
/mod unlock [channel] Unlock channel
/mod slowmode <seconds> [channel] Set slowmode (0 to 21600)
/mod addrole <member> <role> [reason] Assign role
/mod removerole <member> <role> [reason] Remove role

/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 massban <user_ids> [reason] [delete_days] Ban multiple users by ID
/cases clean [count] Remove bot messages in channel
/cases duration <case_number> <duration> Change timed punishment duration
/cases history <user> Export moderation history JSON
/cases import <file> Import 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
/cases snipe Show most recent deleted message in channel

/mod-debug Commands

Command Description
/mod-debug config Show active moderation configuration
/mod-debug log Send a test moderation log entry
/mod-debug test Simulate moderation action (dry run)

Important Notes

  • There is no /mod-config ... command group in the current command surface.
  • Warning thresholds and automod policy settings are configured through Dashboard/API moderation configuration routes.
  • 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
/mod-debug config