---
title: /warnings
description: View, delete, or clear a user's warnings, and configure the warning punishment.
---
## Overview

`/warnings` manages the warnings members accumulate from `/warn`. Use it to review a user's warning history, remove individual warnings, clear all of a user's warnings, or configure what happens when a member hits the warning limit.

## Required Permissions

- **Moderate Members** for `view`, `delete`, and `clear`.
- **Administrator** for `settings`.

## Subcommands

### view

| Option | Required | Description |
|--------|----------|-------------|
| `user` | Yes | User whose warnings to view |

Shows the user's warning count against the configured maximum, with each warning's moderator, reason, and date. Paginated at 5 warnings per page.

### delete

| Option | Required | Description |
|--------|----------|-------------|
| `user` | Yes | User to remove a warning from |

Opens the same paginated list with a select menu. Choosing a warning asks for confirmation, then removes that single warning and decrements the user's warning count.

### clear

| Option | Required | Description |
|--------|----------|-------------|
| `user` | Yes | User to clear all warnings for |
| `reason` | No | Reason for clearing |

Removes all of the user's warnings in one action. The user is DMed with the reason.

### settings

| Option | Required | Description |
|--------|----------|-------------|
| `max_warnings` | No | Warnings allowed before punishment triggers (1–20) |
| `punishment` | No | Action applied at the limit: mute, kick, or ban |
| `mute_duration` | No | Mute length when `punishment` is mute, e.g. `1d`, `12h` |

Run with no options to view current settings. Omitted options keep their current values.

## Behavior

- Reaching `max_warnings` triggers the configured punishment and resets the user's warning count to zero.
- Time format for `mute_duration`: use `s`, `m`, `h`, `d`, `w` (for example `5s`, `10m`, `1d`).
- All warning changes are logged to the log channel if one is configured.