Skip to main content
Moderator commands help staff members effectively and efficiently moderate text and voice channels. These commands can only be used if you have a staff role (eg. moderator, owner). Effective use of moderation commands ensures that community standards are upheld, members feel secure, and discussions remain productive and welcoming for everyone.

/ban

Removes a user from the server, preventing them from rejoining unless unbanned.

Syntax

/ban [user] [duration, optional] [reason, optional] [days, optional]
  • user (required) – Member to ban.
  • duration (optional) – Ban length (1d, 7d, permanent). Default: permanent.
  • reason (optional) – Note for logs.
  • days (optional) – Delete past messages (0, 1, or 7).

Examples

/ban @username
/ban @username spamming ads
/ban @username 7d harassment in chat
/ban @username 7d spamming links 7

/kick

Removes a user from the server without banning them. They can rejoin with an invite.

Syntax

/kick [user] [reason, optional]
  • user (required) – Member to remove.
  • reason (optional) – Note for logs.

Examples

/kick @username
/kick @username posting slurs in chat

/mute

Prevents a user from speaking or typing for a set time.

Syntax

/mute [user] [duration, optional] [reason, optional]
  • user (required) – Member to mute.
  • duration (optional) – Duration (e.g., 10m, 1h, 24h).
  • reason (optional) – Note for logs.

Examples

/mute @username
/mute @username 30m
/mute @username 2h flooding voice chat

/unmute

Restores a muted user’s ability to speak/type.

Syntax

/unmute [user] [reason, optional]
  • user (required) – Member to unmute.
  • reason (optional) – Note for logs.

Examples

/unmute @username
/unmute @username appeal approved

Notes

  • Ensure the user is currently muted; otherwise the command may do nothing.
  • Useful after appeal reviews or when a timeout expires early.

/unban

Lifts a ban, allowing a user to return.

Syntax

/unban [user] [reason, optional]
  • user (required) – Banned user’s ID or username#discriminator.
  • reason (optional) – Note for logs.

Examples

/unban 123456789012345678
/unban 123456789012345678 appeal approved

/warn

Issues a formal warning to a member.

Syntax

/warn [user] [reason, optional]
  • user (required) – Member to warn.
  • reason (optional) – Reason for the warning.

Examples

/warn @username
/warn @username posting NSFW content in general chat
/warn @username spamming links

/warnings

Lists the warnings of a specific user.

Syntax

/warnings [user]
  • user (required) – Member to check warnings for.

Examples

/warnings @username

/clearwarnings

Clears all warnings of a user.

Syntax

/clearwarnings [user]
  • user (required) – Member whose warnings you want to clear.

Examples

/clearwarnings @username

/topwarnings

Shows a ranked list of warnings on the server.

Syntax

/topwarnings

Examples

/topwarnings

/delwarning

Deletes a warning by its ID.

Syntax

/delwarning [id]
  • id (required) – The warning ID from /warnings.

Examples

/delwarning 1

/editwarning

Edits the reason of a warning by its ID.

Syntax

/editwarning [id] [new reason]
  • id (required) – The warning ID from /warnings.
  • new reason (required) – Updated text.

Examples

/editwarning 2 updated reason after appeal

Notes

  • Warnings and moderation logs help maintain accountability.
  • Too many warnings may escalate to mute, kick, or ban.
  • Always provide clear reasons for transparency.

/timeout

Timing out users allows you to punish users by removing their ability to talk or react using Discord’s native Timeout feature.

Syntax

/timeout [user] [duration] [reason, optional]

Examples

/timeout @username 60
/timeout @username 60 spamming in general chats