---
title: /warn
description: Warn a user.
---
## Overview

`/warn` records a warning for a user. When they reach the maximum warnings (set in `/warnings settings`), they are automatically muted, kicked, or banned.

## Required Permissions

- **Moderate Members**

## Options

| Option | Required | Description |
|--------|----------|-------------|
| `user` | Yes | User to warn |
| `reason` | No | Reason for the warning |
| `delete_recent` | No | Number of the user's recent messages to delete from the channel (0–100) |
| `dm_user` | No | Send the user a DM with the reason (default: on) |
| `additional_users` | No | Extra users to warn in the same command, space or comma-separated |
| `proof` | No | Attachment to attach as evidence on the case |

## Behavior

- Below the limit: the user is DMed about the warning (if `dm_user` is on).
- At the limit: the configured punishment (mute, kick, or ban) is applied, the user is DMed, and their warnings are cleared.
- Bots cannot be warned.
- Warning multiple users at once reports which succeeded and which were skipped, with a reason for each skip.
- Configure max warnings, punishment, and mute duration with `/warnings settings`.