Moderation

Manual Moderation Commands

Complete reference for all 21 manual moderation commands. These commands enable real-time enforcement, targeted punishment, message management, and administrative control. Every action is logged, auditable, and can be reversed when appropriate.

User Punishment Commands (8)

/warn - Issue a Warning

/warn <user> [reason]

What it does: Records an infraction against the user. Warnings accumulate and can trigger automatic escalation policies. Each warning is tracked and visible in the moderation log.

Example: /warn @john Spamming in #general - first offense

User notification: DM with reason and warning count

Permissions required: Warn users

/timeout - Apply Discord Timeout

/timeout <user> <duration> [reason]

What it does: Uses Discord's native timeout feature. User cannot send messages, reply, react, or connect to voice channels. Timeout prevents all interaction with the server.

Duration: 1 minute to 28 days. See Duration Format Reference below.

Examples:

  • • /timeout @john 5m Disruptive behavior
  • • /timeout @jane 1h Excessive mention spam
  • • /timeout @bob 1d Harassment and toxicity

Note: Cannot be extended - you must remove and reapply for longer durations.

Permissions required: Timeout users

/untimeout - Remove Timeout

/untimeout <user> [reason]

What it does: Removes an active Discord timeout before the duration expires. User regains full server access immediately.

Example: /untimeout @john Timeout ended - user has cooled off

When to use: Early removal after user demonstrates understanding or improved behavior

Permissions required: Manage timeouts

/mute - Temporarily Mute User

/mute <user> <duration> [reason]

What it does: Assigns a mute role preventing text message sending. User can still read channels, view pins, and receive updates. More flexible than timeout - can have custom duration and per-channel overrides.

Example: /mute @john 30m Arguing with moderators

When to use: Medium-severity violations requiring cooldown. More reversible than timeout.

Permissions required: Mute users

/unmute - Remove Mute

/unmute <user> [reason]

What it does: Removes the mute role and restores user's ability to send messages.

Example: /unmute @john Mute period ended

Permissions required: Manage mutes

/kick - Remove User from Server

/kick <user> [reason] [delete_days]

What it does: Immediately removes user from the server. User can rejoin with a new invite link. All roles and permissions are revoked. Server visibility is not affected.

delete_days: Optional - delete user's messages from past N days (0-7). Useful for removing spam before removal.

Examples:

  • • /kick @john Continued rule violations after warnings
  • • /kick @spam 7 Spam account - deleting last 7 days of messages

Permissions required: Kick members

/ban - Ban Member

/ban <user> [duration] [reason] [delete_days]

What it does: Removes user and prevents rejoin indefinitely (or for specified duration). Bans override invite links. Users cannot rejoin by account recreation or fresh invites unless unbanned.

Parameters:

  • • duration: Optional - ban for N days, then auto-unban. Leave blank for permanent.
  • • reason: Why banned (shown to user in DM)
  • • delete_days: Delete messages from past N days (0-7)

Examples:

  • • /ban @john Harassment and threats
  • • /ban @spam 7 Spam account - deleting messages
  • • /ban @troll 30 Severe toxicity - temporary ban for 30 days

Permissions required: Ban members

/unban - Remove Ban

/unban <user_id> [reason]

What it does: Removes an active ban and allows user to rejoin the server. Requires user ID (not @mention) since user is not in server.

How to get user ID: Enable Discord Developer Mode, right-click the user, and copy their ID. Or check the ban list in Discord server settings.

Example: /unban 123456789 Appeal approved - user has demonstrated reform

Permissions required: Ban members

Message Management Commands (2)

/purge - Delete Multiple Messages

/purge <amount> [user] [type]

What it does: Bulk delete recent messages in current channel. Limited to messages under 14 days old (Discord API limitation). Supports filtering by user or message type.

Parameters:

  • • amount: Number of messages (1-100)
  • • user: Optional - only delete from this user
  • • type: Optional - 'text', 'images', 'links', 'embeds', 'bots'

Examples:

  • • /purge 50 (last 50 messages in channel)
  • • /purge 25 @john (last 25 messages from john)
  • • /purge 30 type:links (last 30 messages with links)

Limits: Maximum 100 messages at once. Deleted messages cannot be recovered. Deletion is logged.

Permissions required: Manage messages

/slowmode - Set Channel Slowmode

/slowmode <seconds> [channel]

What it does: Rate-limits messages in a channel. Users must wait N seconds between messages. Useful for high-spam situations or rapid coordination control.

Parameters:

  • • seconds: 0-21600 (0 disables slowmode, 1-21600 enables it)
  • • channel: Optional - target channel (defaults to current)

Examples:

  • • /slowmode 5 (5 second slowmode in current channel)
  • • /slowmode 30 #announcements (30 second slowmode in #announcements)
  • • /slowmode 0 (disable slowmode)

Permissions required: Manage channels

Channel Management Commands (2)

/lock - Lock Channel

/lock [channel] [reason]

What it does: Prevents members from sending messages in channel while keeping it visible. Moderators can still send messages. Useful during raids, spam attacks, or crisis situations.

Parameters:

  • • channel: Optional - lock this channel (defaults to current)
  • • reason: Why channel was locked (optional)

Examples:

  • • /lock (lock current channel)
  • • /lock #general Raid in progress - please stand by

Permissions required: Manage channels

/unlock - Unlock Channel

/unlock [channel]

What it does: Restores normal messaging permissions to a locked channel. Members regain ability to send messages.

Example: /unlock #general (restore normal permissions)

Permissions required: Manage channels

Moderation Records Commands (4)

/warnings - View User Warnings

/warnings <user>

What it does: Displays all warnings on record for a user. Shows timestamp, reason, and moderator for each warning. Used for determining escalation actions.

Example: /warnings @john (shows all of john's warnings)

Permissions required: View moderation records

/clearwarnings - Clear All Warnings

/clearwarnings <user>

What it does: Removes all warnings from user's record. Use for amnesty periods or after successful appeal. Action is logged.

Example: /clearwarnings @john (clear all warnings)

Permissions required: Manage warnings

/case - View Moderation Case

/case <id>

What it does: Displays detailed information about a specific moderation case. Shows action type, user, moderator, timestamp, reason, and status.

Example: /case 45 (show details of case #45)

Finding case IDs: Use /modlog to get case numbers or check dashboard history

/modlog - View Moderation Log

/modlog [user] [action]

What it does: Displays recent moderation actions filtered by user or action type. Shows case IDs for detailed lookup.

Filters:

  • • /modlog @user (all actions on user)
  • • /modlog action:ban (all bans)
  • • /modlog action:warn (all warnings)

Permissions required: View moderation logs

Moderator Notes Commands (2)

/setnote - Add Moderator Note

/setnote <user> <note>

What it does: Adds a private note to user's moderation record. Notes are invisible to users and visible only to moderators. Useful for context and behavioral patterns.

Examples:

  • • /setnote @john Potential alt account - monitor closely
  • • /setnote @jane Has history of ban evasion attempts

Permissions required: Manage notes

/notes - View Moderator Notes

/notes <user>

What it does: Displays all private moderator notes about a user. Shows timestamp and note author.

Example: /notes @john (view all notes about john)

Permissions required: View notes

Advanced Commands (3)

/massban - Mass Ban Multiple Users

/massban <users...> [reason]

What it does: Ban multiple users in a single command. Useful for coordinated raids or bulk removal of bad actors. Each ban is individually logged and tracked.

Example: /massban @user1 @user2 @user3 Coordinated raid attempt

Limits: Maximum 50 users per command

Permissions required: Ban members (elevated)

/role - Add or Remove Role

/role <user> <role> [duration]

What it does: Toggle a role on/off for a user. If role exists, removes it. If not, adds it. Optional duration auto-removes role after specified time.

Examples:

  • • /role @john Muted (toggle Muted role)
  • • /role @jane Trusted 7d (add Trusted role for 7 days)

Permissions required: Manage roles (for specified role)

/nickname - Change User Nickname

/nickname <user> <name>

What it does: Changes a user's server-specific nickname. Used to force normalization of offensive or inappropriate names. User's actual account name is unchanged.

Examples:

  • • /nickname @john User (rename to "User")
  • • /nickname @jane Member 42 (rename to "Member 42")

Note: Useful for removing hidden unicode characters or offensive names

Duration Format Reference

For any command requiring a duration (timeout, mute, ban), use these formats. All are case-insensitive and stackable.

1m

1 minute

30m

30 minutes

1h

1 hour

2h30m

2 hours 30 minutes

1d

1 day

7d

7 days

1w

1 week

3d12h

3 days 12 hours

Best Practices

Always Document Actions

Every command supports a reason. Always include one. Reasons appear in DMs, audit logs, and are essential for appeals. Clear documentation helps junior staff learn and improves consistency.

Use Graduated Escalation

Follow: Warn → Timeout → Mute → Kick → Ban. This progression gives users multiple chances to improve while demonstrating fair, consistent enforcement. Document escalation in reason text.

Choose the Right Tool

Timeout = Discord-native, visible, quick enforcement. Mute = Flexible, per-channel control. Lock = Channel-level emergency response. Choose based on severity and desired flexibility.

Reference Previous Cases

Consistency matters. When issuing actions, reference similar cases from modlog.

Example: "/warn @user Harassment - consistent with case #42 from 2024-02-15"

Critical Reminders

  • • /purge deletes permanently - cannot be undone
  • • /ban is permanent unless duration specified or unbanned
  • • /timeout has 28-day limit and cannot be extended
  • • /kick users can rejoin with new invites
  • • All actions logged in server audit log and case system
  • • Role-based permissions restrict command access
  • • Users receive DM notifications for warn/timeout/mute/kick/ban
Screenshot: Moderation dashboard showing recent cases, user history, and bulk action panel

Dashboard Guide

Access advanced moderation features through the Security dashboard at /dashboard/security.

Case Management

View, edit, and resolve moderation cases. Filter by status (open/resolved), type, user, or date range. Export cases for external auditing.

User Profiles

Complete history for any member: warnings, cases, notes, bans, roles, and timeline. Useful for determining escalation and pattern analysis.

Automated Enforcement

Configure Anti-Nuke (role/channel creation), Anti-Raid (mass joins), Anti-Spam (message rate), Anti-Link (blocked domains), and Verification settings.

Bulk Actions

Ban/kick multiple users by list, apply roles to bulk members, or mass-remove roles. Preview before execution with dry-run mode.

Frequently Asked Questions

What's the difference between timeout and mute?

Timeout: Discord-native, visible in profile, max 28 days, prevents all interaction.Mute: Role-based, no time limit, customizable per-channel, more flexible. Use timeout for quick enforcement, mute for nuance.

Can I revert a ban?

Yes. Use /unban with the user's ID. Document your reason in the command - it appears in the audit log. You can also set temporary bans with /ban @user 30d.

Can I purge older messages?

Only messages under 14 days old can be bulk purged (Discord limit). For older messages, manually delete or use /ban with purge-days parameter.

Do users know when they're moderated?

Yes. Warn, timeout, mute, kick, and ban all send DM notifications with reason and next steps. This is configurable in dashboard security settings.

How do I find a user's ID?

Enable Discord Developer Mode (Settings → Advanced → Developer Mode), then right-click any user and select "Copy User ID".