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.
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 viewshows exactly what a member or role holds.