Skip to content

Moderation Commands

Current moderation command groups are:

  • /mod — core moderation actions
  • /cases — case management, notes, and moderator tools
  • /automod — a Member's automod strikes
  • /report — Members report a user to your moderators

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

/automod Commands

Strikes are counted whenever an automod rule catches a Member's message and a warning threshold is set on the Automod dashboard page. They are separate from /mod warn warnings. Both commands need Manage Server and reply only to you.

Command Description
/automod strikes <user> Show a Member's current strike count and when their last strike landed
/automod resetstrikes <user> Clear a Member's strike count

/report

Open to every Member. Sends a report to the report webhook and/or report channel configured on the Moderation dashboard page (the mod log channel is the fallback).

Command Description
/report <user> <reason> [evidence] Report a Member, with an optional screenshot or file

Details: Member Reports.

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
/automod strikes user:@User
/report user:@User reason:"Spamming invites"