/timeout
Temporarily stop a member from chatting, reacting or joining voice.
% Aliases: %mute, %to 5s cooldownWhat does /timeout do in Discord? Temporarily stop a member from chatting, reacting or joining voice. Type /timeout <user> <duration> [reason] [silent] [proof] [proof_link] to use it, or %timeout <@user | ID> <duration> [-nodm] [message link] [reason] with the prefix.
Usage #
/timeout <user> <duration> [reason] [silent] [proof] [proof_link]Options #
| Option | Type | Required | What it does |
|---|---|---|---|
user | Member | Required | The member to time out. |
duration | Text | Required | How long it lasts, like 30m, 2h or 7d. The maximum is 28 days. |
reason | Text | Optional | Why you are doing this. Shows in the audit log and in the member's DM. Up to 512 characters. |
silent | True / False | Optional | Set to True to skip the DM notice to the member. Defaults to False. |
proof | File | Optional | Upload a screenshot or file as proof. |
proof_link | Text | Optional | A link to a Discord message that holds the proof. Ignored if you also upload a file. |
Prefix arguments #
These extra bits only apply when you use the % prefix version.
| Argument | Type | Required | What it does |
|---|---|---|---|
-nodm | Flag | Optional | Skip the DM notice. You can also write -silent or -s. |
<message link> | Link | Optional | A link to a Discord message that holds the proof. You can also attach an image to your command instead. |
Permissions #
You need
Ethvex needs
Cooldown
Duration format #
Use a number with a unit: s for seconds, m for minutes, h for hours, d for days or w for weeks. See Durations, IDs and Flags for more.
Adding proof #
Back up the action with a screenshot. With the slash command, upload a file to proof or paste a Discord message link into proof_link. With the prefix command, attach an image or paste a message link anywhere in the command.
- Proof appears as a link on the confirmation and on the final reply, and in the DM to the member unless you use silent mode.
- With a message link, Ethvex uses the first image in that message. If it has no image, the proof links to the message itself.
- If Ethvex can't open the message, the action still goes ahead without proof.
- Discord links to uploaded files can stop working after a while, so keep your own copy of anything important.
Good to know #
- While timed out, the member can read messages but cannot send, react, speak or stream.
- The reply shows exactly when the timeout ends.
- Timing out someone who is already timed out replaces the old timeout with the new one.
- To end it early, use Untimeout.
- Your highest role and the Ethvex role must both be above the member's highest role. Nobody can target the server owner, themselves or Ethvex.
Examples #
/timeout user:@Nova duration:30m reason:Spamming%mute @Nova 2h Being toxic in voice%to @Nova 7d -nodm Repeated violations
Ethvex