/timeout
Temporarily mute a user for a specified duration. The user cannot send messages or join voice channels during the timeout.
Usage
/timeout <target> <duration> [reason]
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
target | User | ✅ | The user to mute |
duration | Number | ✅ | Duration in minutes (1 min – 1 week) |
reason | Text | ❌ | Reason for the timeout |
What Happens
- The user is immediately muted for the specified duration
- A DM notification is sent with the duration, reason, and reference ID
- The timeout expires automatically — no manual action needed
- The action is logged in the moderation log
Example
/timeout @SpamUser 30 Spamming in general chat
Bot Response
- The user receives a DM: "⏳ Timeout Notification" with duration, reason, and reference ID
- Confirmation: "✅ @SpamUser has been timed out for 30 minutes. Reason: Spamming in general chat"
Error Cases
- You cannot timeout bots
- Duration must be between 1 minute and 10,080 minutes (1 week)
- You cannot timeout users with a higher role than the bot
Required Permissions
- Discord permission: Moderate Members
- R&V permission level: Moderator or higher