> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newt.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# Moderation: Bans, Kicks, Warnings, and a Full Case Log

> Ban, kick, timeout, warn, freeze, and imageban members — every action becomes a numbered case you can look up, edit, or audit later.

Every moderation action you take through Newt — a ban, a kick, a timeout, a warning, a freeze, an imageban — becomes a numbered case in a persistent log. That case records who carried out the action, who it was carried out against, when it happened, how long it lasts, and why. You can browse cases, read them individually, edit their reasons, and build up a complete picture of moderation history that stays put even after members leave.

## Set Up the Moderation Log

Run `/logging moderation` and pick a channel. From then on, every action posts there with its case number and full details. Actions still work and are still recorded if you skip this step — they just aren't posted anywhere visible.

## Permission Model

Who can use moderation commands is set on the dashboard's **Permissions** tab, not by Discord permissions alone. Someone with the **Ban Members** permission in Discord still can't run `/ban` until their role is allowed on the Permissions tab. The server owner, Administrators, and any roles you explicitly whitelist can always use moderation commands.

For the bot to action someone, its role must sit above that person in the role hierarchy. Go to **Server Settings → Roles** and drag the bot's role above anyone you want it to be able to action. You can't action someone whose top role is at or above your own, and no one can action the server owner.

## Duration Format

Write durations naturally: `10m`, `2h`, `1d`, `1h30m`. Discord caps timeouts at **28 days**.

## About Warnings

`/warn remove` marks a warning inactive — it stops counting toward a member's total — but it stays visible in `/case list`. Removing a warning never quietly erases the trail.

***

## Commands

### Bans & Kicks

| Command | What it does | Who can use it |
| - | - | - |
| `/ban <member> [reason] [duration] [proof] [soft] [purge_days] [dm]` | Ban permanently or temporarily. A duration like `2h` or `3d` unbans automatically when it's up. Soft ban instantly unbans, clearing messages without keeping the person out. An ID works after they've left. Proof files are kept with the case in the mod log. `dm` controls whether they're told why. | Allowed on dashboard |
| `/unban <user_id> [reason]` | Unban by user ID. | Allowed on dashboard |
| `/kick <member> [reason]` | Remove someone from the server. | Allowed on dashboard |

### Timeouts

| Command | What it does | Who can use it |
| - | - | - |
| `/timeout add <member> <duration> [reason]` | Mute someone for a set duration. | Allowed on dashboard |
| `/timeout remove <member> [reason]` | End a timeout early. | Allowed on dashboard |
| `/timeout list` | Show who is currently timed out and when each one lifts. | Allowed on dashboard |

### Warnings

| Command | What it does | Who can use it |
| - | - | - |
| `/warn add <member> <reason>` | Warn a member and record it against them. | Allowed on dashboard |
| `/warn list <member>` | Show their active warnings. | Allowed on dashboard |
| `/warn remove <case_id>` | Deactivate a warning by its case number. It stops counting toward their total but stays visible in the case log. | Allowed on dashboard |

### Imageban

| Command | What it does | Who can use it |
| - | - | - |
| `/imageban add <member> [reason] [duration]` | Block the member from posting images, GIFs, videos, stickers, and media links. Any post containing one is deleted on sight and a card in the channel explains why. Give a duration like `2d` or `1w` and it lifts itself automatically; leave it out and it lasts until you run `/imageban remove`. | Allowed on dashboard |
| `/imageban remove <member> [reason]` | Restore the member's ability to post images. | Allowed on dashboard |
| `/imageban list` | Show who is currently imagebanned and when each ban lifts. Only you see the answer. | Allowed on dashboard |

### Freeze

<Note>
  The Frozen role is created automatically the first time you use `/freeze add`. Leaving and rejoining the server does not escape a freeze — the member still has no roles when they return. When you unfreeze them, their original roles are restored; any role deleted in the meantime can't come back, and the response tells you how many were lost.
</Note>

| Command | What it does | Who can use it |
| - | - | - |
| `/freeze add <member> [reason]` | Remove all of the member's roles and assign a Frozen role that can't see or talk in any channel, react, or join voice. Their roles are saved and restored on unfreeze. Leaving and rejoining doesn't escape it. | Allowed on dashboard |
| `/freeze remove <member> [reason]` | Unfreeze the member and restore their roles. Any role deleted in the meantime can't come back, and the response says how many were lost. | Allowed on dashboard |
| `/freeze list` | Show who is frozen, by whom, and why. Only you see the answer. | Allowed on dashboard |
| `/freeze removeall [reason]` | Unfreeze everyone in the server at once and restore their roles. | Allowed on dashboard |

### Cases & Notes

| Command | What it does | Who can use it |
| - | - | - |
| `/case list [type] [user] [mod]` | Browse the server's cases ten at a time, newest first, one line each — case number, action type, who it was against, and when. Filter by type, by member, or by moderator. The magnifier button jumps to a page by number. Posts in the channel; only the person who ran it can press the buttons. | Allowed on dashboard |
| `/case view <case_id>` | Show the full details of a single case — what happened, to whom, by whom, when, duration, reason, and any edits. | Allowed on dashboard |
| `/case reason <case_id> <reason>` | Edit a case's reason. Who made the edit and when is recorded on the case. | Allowed on dashboard |
| `/note <member> <text>` | Add a staff note to a member. Recorded like a case, never counts as a warning, and the member is never told it exists. | Allowed on dashboard |

### Channel Control

| Command | What it does | Who can use it |
| - | - | - |
| `/purge <amount> [member] [contains] [bots]` | Bulk delete recent messages, optionally filtered by member, text content, or bots only. | Allowed on dashboard |
| `/slowmode <duration>` | Set this channel's slowmode. Use `0` to turn it off. | Allowed on dashboard |
| `/lock [reason]` | Stop members posting in this channel. | Allowed on dashboard |
| `/unlock [reason]` | Allow posting again. | Allowed on dashboard |

### Logging

| Command | What it does | Who can use it |
| - | - | - |
| `/logging moderation [channel]` | Set where numbered moderation cases are posted. Leave the channel out to switch it off. | Manage Server |