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

# /timeout

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

Time a member out. 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

```
/timeout user:<user> duration:<duration> 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 time out |
| `duration` | text | Yes | How long: 10m, 2h, 1d (28 days at most) (up to 20 characters) |
| `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 |
| --- | --- |
| `/timeout user:@Minh duration:1h reason:Chửi người khác` | 🔇 Minh can't chat or talk in voice for 1 hour. Durations look like 10m, 2h, 1d (28 days at most). |

## 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) |
| Invalid duration. Examples: `10m`, `2h`, `1d` (28 days at most). | Write durations like 10m, 2h, 1d or a number of minutes. Discord allows timeouts of up to 28 days. |
| 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

- [`/untimeout`](https://clanzy.app/en/docs/commands/untimeout): Remove a timeout early
- [`/warn`](https://clanzy.app/en/docs/commands/warn): Warn a member
- [`/cases`](https://clanzy.app/en/docs/commands/cases): A member's moderation history
- All commands: [command list](https://clanzy.app/en/docs/commands)

Updated: 2026-11-20
