> Full Clanzy docs index (for AI agents): https://clanzy.app/en/llms.txt · HTML page: https://clanzy.app/en/docs/commands/warn

# /warn

Clanzy's /warn command: Warn a member. Syntax, who can use it, bot permissions, examples and common errors.

Warn a member. Clanzy never acts on admins or the owner, and only on members whose role is below yours and below Clanzy's. The member gets a DM with the reason (can be turned off in the dashboard). Every action is kept as a case.

## Syntax

```
/warn user:<user> reason:<reason>
```

Type `/` in a server channel, pick the command from the list and fill in the fields Discord shows.

## Options

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `user` | member | Yes | Member to warn |
| `reason` | text | No | Reason (sent to the member and kept in the case) (up to 500 characters) |

## Who can use it

- **Members:** Mods with Timeout Members. Discord hides the command from members without it.
- **Clanzy needs:** Timeout Members.
- **Feature:** [Moderation](https://clanzy.app/en/docs/moderation)

See [permissions and who can use what](https://clanzy.app/en/docs/getting-started/permissions) to change who sees commands in Discord.

## Examples

| You type | Clanzy does |
| --- | --- |
| `/warn user:@Minh reason:Spam tag cả kênh` | ⚠️ Warned Minh (case #12). They have 2 active warns. Minh gets a DM with the reason. At 3 warns Clanzy applies the server's rule (a timeout by default). |

## In the dashboard

The related settings are in the [dashboard](https://app.clanzy.app/?open=moderation): pick your server and the section opens.

## Errors you may see

| Clanzy says | What it means and the fix |
| --- | --- |
| This command is for mods: you need the **Timeout Members** permission. | This command is for mods. Ask an admin to give your role the Timeout Members permission. [More](https://clanzy.app/en/docs/voice-history) |
| This server requires a reason. Add `reason:` and send it again. | An admin turned on Require a reason. Fill in the reason field and send it again. [More](https://clanzy.app/en/docs/moderation) |
| You can't do that to yourself 😅 | You picked yourself. Pick the member you want to act on. |
| You can't act on an admin. Clanzy never touches members with Administrator. | Clanzy never acts on members with Administrator or on the owner. Handle it in Discord directly if you really must. [More](https://clanzy.app/en/docs/moderation) |
| @Tuan has a role equal to or above yours, so you can't act on them. | Their highest role is equal to or above yours. Ask someone with a higher role. [More](https://clanzy.app/en/docs/moderation) |
| @Tuan's role sits above Clanzy's. Move Clanzy's role higher (Server Settings → Roles) and try again. | Their role sits above Clanzy's. Drag Clanzy's role higher in Server Settings → Roles. [More](https://clanzy.app/en/docs/getting-started/role-order) |

## Related commands

- [`/cases`](https://clanzy.app/en/docs/commands/cases): A member's moderation history
- [`/timeout`](https://clanzy.app/en/docs/commands/timeout): Time a member out
- [`/kick`](https://clanzy.app/en/docs/commands/kick): Kick a member from the server
- All commands: [command list](https://clanzy.app/en/docs/commands)

Updated: 2026-11-20
