Skip to content
AzraDocs
Pricing Dashboard
Command reference

Moderation Commands

Warn, mute, kick, ban and jail members, purge messages, lock channels and read the numbered case record. Every action runs through one executor, so it is cased, logged, DM’d and undoable whichever surface issues it.

3 sections10 min readOpen the dashboard
On this page

Moderation#

Warn, mute, kick, ban and jail members, purge messages, lock channels and read the numbered case record. Every action runs through one executor, so it is cased, logged, DM’d and undoable whichever surface issues it.

Slash Member actions — one command each#

Each action is its own top-level command — /warn, /kick, /ban — with no group or prefix to remember. Each keeps its own permission, so a server delegating junior moderation hands out exactly the actions it means to. Add and remove pairs (/role, /timeout, /temprole) stay one command with two subcommands, so related actions sit together in the picker.

Command What it does Permission
/warn <user> <reason> [duration] [silent] [note] Warn a member. Counts toward automatic escalation; a duration makes it a temporary warning. Warn
/warnings <user> List a member’s warnings and where they stand on the escalation ladder. Warnings
/kick <user> <reason> Remove a member from the server. Kick
/ban <user> <reason> [delete_message_history] Ban a user, optionally deleting their recent message history. Ban
/unban <user_id> <reason> Lift a ban so the user can rejoin. Unban
/tempban <user> <duration> <reason> Ban a user and unban them automatically when it expires. Tempban
/purge <amount> [user] [filter] [contains] Bulk delete up to 500 messages, optionally filtered by author, content or attachments. Purge
/nickname <user> [nickname] [reason] Change a member’s nickname — leave it empty to reset to their username. Nickname
/timeout add <user> <duration> <reason> Time a member out, e.g. 45m, 12h, 7d (Discord’s maximum is 28d). Timeout
/timeout remove <user> [reason] End a timeout early. Timeout
/temprole add <user> <role> <duration> [reason] Add a role that is removed automatically on expiry. Temprole
/temprole remove <user> <role> <duration> [reason] Remove a role and restore it automatically on expiry. Temprole
/role add <user> <role> [reason] Give a member a role. It stays until somebody removes it. Add Role
/role remove <user> <role> [reason] Take a role off a member. Remove Role

Slash /punish — beyond Discord’s own verbs#

Each is its own permission on purpose: "may kick" and "may permanently blacklist" are different levels of trust, and reviewing an appeal is routinely delegated to staff who may not issue the punishment.

Command What it does Permission
/punish softban <user> <reason> Ban then immediately unban — removes the member and purges their recent messages. Soft Ban
/punish tempkick <user> <duration> <reason> Kick, then remove them again on every rejoin until the duration expires. Temporary Kick
/punish jail <user> <reason> [duration] Strip every manageable role and assign the jail role. Roles are stored and restored on release. Jail / Quarantine
/punish unjail <user> Release from jail and restore the roles they held before. Unjail / Release
/punish quarantine <user> <reason> Add the quarantine role, leaving their own roles alone. Jail / Quarantine
/punish unquarantine <user> Remove the quarantine role. Unjail / Release
/punish blacklist <user> <reason> Bar a user — they are kicked or banned again every time they join. Blacklist User
/punish unblacklist <user> Lift a blacklist, including the ban a ban-mode blacklist left behind. Remove Blacklist
/punish lock <user> <reason> Stop one member talking anywhere, using per-user channel overwrites. Their roles are untouched. Lock User
/punish unlock <user> Lift a user lock, removing exactly the overwrites it added. Unlock User

Slash Voice moderation — one command each#

Six unrelated actions, not two halves of one, so each is its own top-level command with no /voice group to remember — exactly like the member actions above. Every one keeps its own permission and its own prefix twin.

Command What it does Permission
/mute <user> [reason] Server-mute a member in voice channels. Voice Mute
/unmute <user> [reason] Remove a member’s server voice mute. Voice Unmute
/deafen <user> [reason] Server-deafen a member in voice channels. Voice Deafen
/undeafen <user> [reason] Remove a member’s server voice deafen. Voice Undeafen
/move <user> <channel> [reason] Move a member into another voice channel. Voice Move
/disconnect <user> [reason] Disconnect a member from their voice channel. Voice Disconnect

Slash /channel — channel state#

Command What it does Permission
/channel lock [channel] [reason] Prevent @everyone sending messages in a channel. Lock
/channel unlock [channel] [reason] Restore @everyone sending permissions in a locked channel. Unlock
/channel lockdown lock [reason] [category] Lock every text channel, or just one category. Does not touch the server verification level. Lockdown
/channel lockdown unlock [reason] [category] Unlock the channels a previous lockdown locked. Lockdown

Slash /slowmode — rate limit#

The one slowmode command: the old /channel slowmode subcommand was removed rather than kept as a second path to the same action.

Command What it does Permission
/slowmode set <duration> [channel] Enable slowmode — e.g. 10s, 1m, 10m, 1h30m (max 6 hours). Slowmode
/slowmode remove [channel] Disable slowmode in a channel. Slowmode

Slash /pin & /unpin — message pins#

Command What it does Permission
/pin <message_id_or_link> Pin a message — by its ID or message link. Pin
/unpin <message_id_or_link> Remove the pin from a message. Unpin

Slash /thread — create or close a thread#

One command for both directions; `close:true` is an option, not a second command. `message` accepts an ID or a message link, and channel_id disambiguates a bare ID that belongs to another channel. Without `message` the replied-to message is used where Discord supplies it (`!thread` covers text replies); with `close:true` and no message, the thread the command runs in is deleted. A public thread is attached to its source message — Discord cannot attach a private thread to a message, so private:true creates one in the same channel and links the message inside it.

Command What it does Permission
/thread [message] [name] [channel_id] [private] Start a thread from a message — by ID, link, or the message you replied to. The name defaults to the message text. Returns the thread link. Create Thread
/thread close:true [message] [channel_id] Delete the targeted thread: the thread you are in, the one you replied in, or the one a message ID belongs to. Needs Manage Threads. Create Thread

Slash /case — the moderation record#

Reading history is split from changing a case: undoing a punishment and rewriting a stated reason are both audit-sensitive and separately gated.

Command What it does Permission
/case view <number> Show one case in full — reason, evidence, DM, appeal link and expiry. View Cases
/case history <user> A member’s complete moderation record. View Cases
/case list [user] [active] The server’s most recent cases, optionally only punishments still in force. View Cases
/case note <number> <note> Add an internal note. Staff only — the member never sees it. Add Case Note
/case reason <number> <reason> Correct a stated reason. The correction is itself recorded as a note. Edit Case Reason
/case undo <number> [reason] Reverse a punishment. The reversal gets its own case. Undo Case
/case escalation <user> Preview the punishment escalation will apply to this member next. Escalation Preview

Slash /massmod — bulk actions#

/massmod stays one grouped command rather than four top-level ones: its bulk actions share a single Mass Mod capability, and keeping them together keeps the command list short. Each action still names its own target, reason and — where relevant — role or duration.

Command What it does Permission
/massmod ban <reason> [delete_messages] Ban up to 10 members chosen from a user picker. Mass Mod
/massmod kick <reason> [role] Kick picked members, or everyone holding a given role. Mass Mod
/massmod timeout <duration> <reason> [role] Time out picked members, or everyone holding a given role. Mass Mod
/massmod role <action> <role> [reason] Add or remove a role for up to 10 members via a user picker. Mass Mod

Menu Right-click a member#

User context-menu commands. They share their slash twin’s permission, so a denied capability cannot be reached by right-clicking instead.

Command What it does Permission
Quick Ban Ban the member you right-clicked. Ban
Quick Kick Kick the member you right-clicked. Kick
Quick Timeout (1h) Time the member out for one hour. Timeout

Text Text commands#

Shown with the default ! prefix — use your server’s prefix or @mention the bot. Every punishing text command runs through the same executor as its slash twin, so it produces the same case, DM, log and escalation. Flags: --silent, --dm <text>, --note <text>, --for <duration>, --category <name>, --days <n>.

Command What it does Permission
!warn <@user> <reason> [--for 30d] [--category spam] Warn a member. Counts toward automatic escalation. Warn
!warnings <@user> View a member’s warnings and ladder position. Alias: !warns Warnings
!kick <@user> <reason> Kick a member from the server. Kick
!ban <@user|id> <reason> [--days 1] Ban a user. Takes no duration — a tempban carries its own permission. Ban
!unban <id> <reason> Lift a ban so the user can rejoin. Unban
!timeout <@user> <duration> <reason> Time a member out, e.g. 10m, 1h30m, 7d (max 28d). Timeout
!untimeout <@user> [reason] Remove a timeout from a member. Timeout
!mute <@user> [reason] Server-mute a member in voice. This is the VOICE mute — use !timeout to time somebody out. Voice Mute
!unmute <@user> [reason] Remove a member’s voice server-mute. Voice Unmute
!deafen <@user> [reason] Server-deafen a member in voice channels. Voice Deafen
!undeafen <@user> [reason] Remove a member’s voice server-deafen. Voice Undeafen
!move <@user> <channel> [reason] Move a member into another voice channel — by mention, ID or name. Voice Move
!disconnect <@user> [reason] Disconnect a member from their voice channel. Voice Disconnect
!softban <@user> <reason> [--days 1] Ban then immediately unban, purging recent messages. Soft Ban
!jail <@user> <reason> [--for 12h] Strip every manageable role and assign the jail role. Jail / Quarantine
!unjail <@user> [reason] Release from jail and restore the stored roles. Unjail / Release
!blacklist <@user|id> <reason> Bar a user — removed again on every join. Blacklist User
!unblacklist <@user|id> [reason] Lift a blacklist and any ban it left behind. Remove Blacklist
!case <view|history|list|note|reason|undo|escalation> Read and correct the moderation record. Each subcommand carries its slash twin’s permission. Alias: !cases View Cases
!purge <1-100> [@user] Bulk delete recent messages. Alias: !clear Purge
!slowmode <10s|1m|10m|seconds|remove> Set this channel’s slowmode — e.g. 10s, 1m, 10m (max 6h); remove to disable. Slowmode
!lock [reason] Prevent @everyone sending messages in this channel. Lock
!unlock [reason] Restore @everyone sending permissions here. Unlock
!pin [message id or link] Pin a message — reply to it, or pass its ID / link. Pin
!unpin [message id or link] Remove a message’s pin. Reply to it, or pass its ID / link. Unpin
!thread [reply|current] [--private] <name> Start a thread from the message you replied to, or from the command message. Add --private for a private thread. Create Thread
!nick <@user> [new nickname] Change or reset a member’s nickname. Nickname
!addrole <@user> <@role|name> [reason] Give a member a role — by mention, ID or exact name. Alias: !giverole Add Role
!removerole <@user> <@role|name> [reason] Take a role off a member. Alias: !takerole Remove Role

Other modules#

Every other part of Azra that adds commands to your server.

Notes that apply everywhere#

Text commands#

Every text command is shown with the default ! prefix. Your server can change it (!prefix <new>, or the dashboard), and @mentioning the bot always works as a prefix whatever you set — so @Azra help is a reliable way back in if you forget it.

Permissions#

Azra does not read Discord's own permissions to decide who may run what — it has its own Permission Manager, and the server owner and Discord Administrators always hold everything. A capability is an action, not a command path: denying Ban blocks /ban, !ban and the right-click Quick Ban together, so a restriction cannot be dodged by switching surface.

If a command does not appear in Discord#

  • Commands register globally and can take a few minutes to show up after the bot joins. Fully restarting your Discord client usually settles it.
  • Check the module is switched on for your server, and that your plan covers it — see Plans.
  • A command you cannot see may simply not be granted to you. /permissions view shows exactly what a member or role holds.