Skip to main content
Moderation commands give your staff tools to warn, mute, remove, and track members. All moderation actions are recorded as numbered cases in the database and can optionally be logged to dedicated channels via /modlog.
Moderation commands send an ephemeral DM notification to the target user by default. This behaviour is controlled by config.moderation.dmNotifications.

​
Warning system

​
/warn

Issues a warning to a member, creates a moderation case, and records a warning with severity and point tracking. If escalation is configured, the bot checks whether the new warning pushes the user over any threshold. Permission: Moderator
OptionTypeRequiredDescription
userUserYesThe member to warn
reasonStringNoReason for the warning
severityChoiceNolow (1 pt), medium (2 pts), or high (3 pts). Defaults to low
/warn user:@alice reason:Spamming in #general severity:low

/warn user:@bob severity:high

​
/warnings

Displays a paginated list of warnings for a user, showing active/expired/removed status, severity, points, and the case each warning is linked to. Permission: Moderator
OptionTypeRequiredDescription
userUserYesThe member to look up
active_onlyBooleanNoShow only active warnings. Defaults to false (show all)
pageIntegerNoPage number (minimum 1). Defaults to 1
/warnings user:@alice

/warnings user:@alice active_only:true page:2

​
/editwarn

Edits the reason or severity of an existing warning by its numeric ID. At least one of reason or severity must be provided. Permission: Moderator
OptionTypeRequiredDescription
idIntegerYesThe warning ID to edit (minimum 1)
reasonStringNoNew reason text
severityChoiceNoNew severity: low, medium, or high
/editwarn id:42 reason:Updated reason after review

/editwarn id:42 severity:medium

​
/removewarn

Deactivates a single warning by ID. The warning is marked inactive and the user’s active point total decreases accordingly. Permission: Moderator
OptionTypeRequiredDescription
idIntegerYesThe warning ID to remove (minimum 1)
reasonStringNoReason for removing the warning
/removewarn id:17

/removewarn id:17 reason:Issued in error

​
/clearwarnings

Deactivates all active warnings for a user in one action. Use this when resetting a member’s slate after a probation period. Permission: Moderator
OptionTypeRequiredDescription
userUserYesThe member whose warnings to clear
reasonStringNoReason for clearing all warnings
/clearwarnings user:@alice

/clearwarnings user:@alice reason:Completed probation

​
Member removal

​
/kick

Kicks a member from the server and records a moderation case. The member can rejoin with a new invite. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe member to kick
reasonStringNoReason for the kick
/kick user:@alice reason:Repeated rule violations

​
/ban

Permanently bans a user and optionally deletes their recent message history. Works even if the user is not currently in the server. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe user to ban
reasonStringNoReason for the ban
delete_messagesIntegerNoDays of message history to delete (0–7). Defaults to 0
/ban user:@alice reason:Harassment delete_messages:7

/ban user:@alice

​
/tempban

Bans a user for a fixed duration, then automatically unbans them when the timer expires. The unban is scheduled internally — no manual follow-up is needed. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe user to ban
durationStringYesHow long to ban them (e.g. 1d, 7d, 2w)
reasonStringNoReason for the ban
delete_messagesIntegerNoDays of message history to delete (0–7). Defaults to 0
/tempban user:@alice duration:7d reason:Repeated spamming

/tempban user:@alice duration:2w delete_messages:1

​
/softban

Bans and immediately unbans a user. The member is not removed long-term, but Discord deletes their recent messages as part of the ban process. Defaults to deleting 7 days of messages. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe member to softban
reasonStringNoReason for the softban
delete_messagesIntegerNoDays of messages to delete (0–7). Defaults to 7
/softban user:@alice reason:Spam cleanup

/softban user:@alice delete_messages:3
If the automatic unban fails after three attempts, the user remains permanently banned. The bot will warn you in the command response — manually unban the user from Server Settings → Bans.

​
/unban

Unbans a user by their Discord user ID. Use this to lift a ban applied by /ban or /tempban before its scheduled expiry. Permission: Admin
OptionTypeRequiredDescription
user_idStringYesThe Discord user ID of the person to unban
reasonStringNoReason for the unban
/unban user_id:123456789012345678 reason:Appeal accepted
You can find a user’s ID by enabling Developer Mode in Discord settings, then right-clicking their name and selecting Copy User ID.

​
Timeouts

​
/timeout

Applies Discord’s native timeout to a member for a specified duration (maximum 28 days). While timed out, the member cannot send messages, react, join voice channels, or interact in any channel. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe member to time out
durationStringYesTimeout duration (e.g. 30m, 1h, 7d). Maximum 28d
reasonStringNoReason for the timeout
/timeout user:@alice duration:1h reason:Heated argument

/timeout user:@alice duration:30m

​
/untimeout

Immediately removes an active timeout from a member and records a moderation case. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe member to un-timeout
reasonStringNoReason for removing the timeout
/untimeout user:@alice reason:Calmed down, returning early

​
Channel management

​
/purge

Bulk-deletes messages from the current channel. Six filter modes are available as subcommands. Discord only allows bulk deletion of messages less than 14 days old — older messages are automatically excluded. Permission: Admin
Deletes the most recent N messages regardless of author.
OptionTypeRequiredDescription
countIntegerYesNumber of recent messages to scan (1–100)
/purge all count:50

​
/lock

Locks a text channel so @everyone cannot send messages. Posts a visible notification embed in the locked channel. Permission: Admin
OptionTypeRequiredDescription
channelChannelNoText channel to lock. Defaults to the current channel
reasonStringNoReason shown in the channel notification
/lock reason:Cooling off after heated discussion

/lock channel:#announcements reason:Maintenance

​
/unlock

Restores messaging permissions in a locked channel. Posts a visible notification embed in the unlocked channel. Permission: Admin
OptionTypeRequiredDescription
channelChannelNoText channel to unlock. Defaults to the current channel
reasonStringNoReason shown in the channel notification
/unlock

/unlock channel:#announcements reason:Maintenance complete

​
/slowmode

Sets a per-user message cooldown in a text channel. Pass 0 to disable slowmode entirely. Maximum duration is 6 hours. Permission: Admin
OptionTypeRequiredDescription
durationStringYesCooldown duration (e.g. 5s, 1m, 1h). Use 0 to disable
channelChannelNoText channel to configure. Defaults to the current channel
reasonStringNoReason for the change
/slowmode duration:30s

/slowmode duration:0 reason:Event over

/slowmode duration:1m channel:#support

​
Case management

​
/case

Inspects and manages the moderation case log. Every moderation action (warn, kick, ban, timeout, purge, lock, etc.) creates a case automatically. Permission: Admin
Displays a full embed for a single case.
OptionTypeRequiredDescription
case_idIntegerYesThe case number to view
/case view case_id:42
/case delete permanently removes the case record. This cannot be undone.

​
/modlog

Configures which channels receive moderation log embeds. You can route different event categories (warns, bans, kicks, etc.) to separate channels, or use a single default channel for everything. Permission: Admin
Opens an interactive menu to select an event category and assign a log channel. The menu times out after 5 minutes.Event categories available for routing:
  • Default — fallback for any unconfigured category
  • Warns — warning events
  • Bans — ban, unban, and tempban events
  • Kicks — kick events
  • Timeouts — timeout and untimeout events
  • Purges — message purge events
  • Locks — channel lock and unlock events
/modlog setup

​
/history

Shows the full moderation case history for a user — up to 25 most recent cases — along with a summary breakdown by action type. Permission: Admin
OptionTypeRequiredDescription
userUserYesThe member to look up
/history user:@alice

Build docs developers (and LLMs) love

Get started for freeTalk to us