Moderation commands — parameter reference
Detailed options for moderation slash commands. Requires Moderation enabled in Feature Centre and each command enabled on the Commands tab.
Set your mod log channel with /setmodlog or the Moderation dashboard panel.
/warn
| Parameter | Required | Description |
|---|---|---|
user | Yes | Member to warn |
reason | No | Reason for the warning |
Discord permission: Manage Messages
/kick
| Parameter | Required | Description |
|---|---|---|
user | Yes | Member to kick |
reason | No | Reason for the kick |
Discord permission: Kick Members
Cannot target the server owner, yourself, or members with equal/higher roles.
/ban
| Parameter | Required | Description |
|---|---|---|
user | Yes | Member to ban |
duration | No | Temporary ban length. Leave empty for permanent. Format: 30d, 2w, 1mo (s/m/h/d/w/o units) |
delete_days | No | Delete message history: 0–7 days (default 0) |
reason | No | Ban reason (logged and sent to mod log) |
Discord permission: Ban Members
Creates a case ID in the response. On Squad+ plans with ban sync, bans may propagate to grouped servers.
Examples
/ban user:@Member reason:Harassment delete_days:1
/ban user:@Member duration:30d reason:Repeat offences/unban
| Parameter | Required | Description |
|---|---|---|
user_id | Yes | Discord user ID of the banned user |
reason | No | Reason for the unban |
Discord permission: Ban Members
/mute
Applies a Discord timeout and/or muted role depending on Moderation → Mute mode in the dashboard.
| Parameter | Required | Description |
|---|---|---|
user | Yes | Member to mute |
duration | Yes | Length of mute. Format: 30s, 5m, 2h, 1d, 1w — max 28 days |
reason | No | Reason (logged) |
Discord permission: Moderate Members
Mute modes (dashboard):
- Timeout only — Discord native timeout
- Muted role only — assigns configured muted role (must be set in Moderation settings)
- Both — timeout + muted role
/unmute
| Parameter | Required | Description |
|---|---|---|
user | Yes | Member to unmute |
reason | No | Reason (logged) |
Discord permission: Moderate Members
Removes timeout and/or muted role per server configuration.
/case
| Parameter | Required | Description |
|---|---|---|
case_id | Yes | Case ID from a prior moderation action |
Look up details for a logged moderation case.
/prune
Bulk-delete messages. Requires Manage Messages. Pinned messages are skipped. Discord bulk delete only works on messages ≤ 14 days old.
/prune count
| Parameter | Required | Description |
|---|---|---|
amount | Yes | Delete the last 1–100 messages in this channel |
/prune from
| Parameter | Required | Description |
|---|---|---|
message_id | Yes | Delete from this message through the latest message in the channel |
Shows a warning if more than 50 messages would be deleted.
/prune user
| Parameter | Required | Description |
|---|---|---|
target | Yes | User whose messages to delete |
duration | Yes | Time window: 1h · 6h · 24h · 7d · 30d · all |
scope | Yes | channel = current channel only · server = all text channels the bot can read |
Shows a warning if more than 50 messages would be deleted.
Examples
/prune count amount:25
/prune from message_id:1234567890123456789
/prune user target:@Spammer duration:24h scope:channel/sticky
Posts a message that stays pinned to the bottom of the channel (re-posted when new messages arrive).
| Parameter | Required | Description |
|---|---|---|
message | Yes | Sticky content (max 2000 characters) |
Discord permission: Manage Messages
Use /unsticky in the same channel to remove.
/unsticky
No parameters. Removes the sticky message in the current channel.
Discord permission: Manage Messages
/setmodlog
| Parameter | Required | Description |
|---|---|---|
channel | Yes | Channel where moderation actions are logged |
Discord permission: Manage Server
Alternatively configure from Feature Centre → Moderation.
/moderation
Admin utility to enable/disable moderation subcommands from Discord (advanced).
| Subcommand | Description |
|---|---|
status | Show which moderation commands are enabled |
enable | Enable a command (command option) |
disable | Disable a command (command option) |
reset | Reset to defaults |
Prefer the dashboard Commands tab for day-to-day toggling.
General rules
- Bot role must be above the target member's highest role
- Cannot action the server owner or yourself
- All actions log to the mod channel when configured
- Grant command access per role under Settings → Permissions