Discord Temporary Ban and Timeout: Which and When?

Timeout or temporary ban?

A simple rule for deciding: a short timeout is usually enough for a one-off argument or spam. If the violation is repeated or if the member needs to be completely absent from the server for a while, a temporary ban is more appropriate.

This topic in VeyroBot:Discord Moderation Bot →

Module, permission and role order

• The moderation module must be enabled. If the Moderation & Logging switch on the panel's Overview screen is turned off, these four commands will not work; the bot will inform you that the module is disabled.
• Have the correct permissions. You need the Ban Members permission for /ban and /unban, and the Moderate Members permission for /timeout and /untimeout.
• Check role hierarchy. Unless you are the server owner, the target's highest role must be lower than yours. VeyroBot's role must also be higher than the target's, and the bot must possess the same permissions.
• Who cannot be penalized? Yourself, VeyroBot, and the server owner. Members with Administrator permissions also cannot be timed out.
• Select a log channel. For cases to appear in the moderation log channel, the module must be enabled under the Audit Logs tab and a Moderation Log Channel must be selected. If no channel is set, the case will still be recorded, but no log message will be sent.

You can find detailed information on how role hierarchy affects penalties in the Discord role and permission system guide.

Step 1: Issue a timeout

Command: /timeout target:@member duration:30m reason:Spam. duration is required, while reason is optional.

• Units: s for seconds, m for minutes, h for hours, d for days. Numbers without units are counted as minutes; writing 45 makes the duration 45 minutes.
• The duration cannot be shorter than 5 seconds or longer than 28 days. 28d is valid, while 29d will be rejected.
• Timeouts can only be given to members currently in the server. If the target is not in the server, the command will notify you.

The response will display the duration and case number. The same action can also be performed in the panel's Web Moderation tab: enter the user ID, select Timeout as the action, and type a minute value between 1 and 40320 in the Duration (Min) field. 40320 minutes equals 28 days.

Step 2: Issue a temporary ban

Command: /ban target:@member duration:7d reason:Advertising. If duration is left blank, the ban is permanent.

• The format consists of a number and a single letter: m for minutes, h for hours, d for days, w for weeks.
• The duration must be between 1 minute and 365 days. Values outside this range will cause the command to error out, and no one will be banned.
• The optional delete_messages option also deletes the user's messages from the last 1 hour, 24 hours, or 7 days.
• The ban is applied even if the target is not currently in the server. If the user is already banned, the command will not open a new case and will state they are "already banned".

The response displays a countdown showing when the ban will be lifted. The moderation log also includes the expiration date and remaining time.

In the panel, the same action is performed via Web Moderation under the Ban action. Enter the duration in the same format in the Ban Duration field, or leave it blank for a permanent ban. You can also ban someone who is not in the server using their user ID in the panel.

What happens when the duration expires?

For timeouts, VeyroBot transmits the end time to Discord, and the restriction is lifted on Discord's end once the time is up. A separate case log is not created for this.

For temporary bans, VeyroBot tracks the end time. The scheduler runs every minute and lifts expired bans. It then opens an unban case log with the reason "Temporary ban expired" and posts it to the moderation log channel. Because the record remains in the database, the duration is not lost even if the bot restarts.

• If a ban cannot be lifted due to a temporary error, it will be retried in the next cycle. If 24 hours pass past the expiration time and it still cannot be lifted, the record is deleted and the ban remains in place.
• VeyroBot does not send direct messages to users. If you want to notify the person that their ban has been lifted, you should do so yourself.

Step 3: Lift the penalty early

• /untimeout target:@member reason:… immediately removes the member's mute. The member must be in the server and actually muted. The role hierarchy rule applies here as well.
• /unban userid:… reason:… requires a 17–20 digit user ID rather than a mention. You can copy the ID from the ban record in the moderation log; it is listed right next to the user's name.
• If you lift a temporary ban using /unban or through Discord's ban list, VeyroBot's timer is also cleared. If you ban the person again later, the old duration will not lift the new ban.

There is no ban or timeout lifting action in the Web Moderation tab. Lifting penalties in VeyroBot is done via commands.

If the duration was typed wrong or the ban did not lift

• Mistaking the m letter for months. 1m is one minute. For a one-month ban, write 30d or 4w.
• Combining two units. 1d12h is invalid; write 36h instead. Timeouts do not support the w unit, and bans do not support the s unit.
• Re-running the /ban command to change the duration. The command will not re-ban someone who is already banned. Remove the ban first, then ban them with the new duration.
• Issuing penalties in a public channel. Confirmation of a successful action is visible to everyone in the channel where you typed the command; reasons are also shown in ban and timeout confirmations. Only error messages are visible to you privately. Use commands in designated staff channels.
• Revoking the bot's ban permissions later. In this case, temporary bans cannot be lifted; after 24 hours, the attempts stop and the ban remains in place.

Should raid accounts get a temporary penalty?

Suitable for: Servers that enforce rules progressively. A system of warnings first, followed by a short timeout, and then a temporary ban for repeated offenses gives members a second chance, with every step visible in the case history.

Not suitable for: Raid accounts, scammers, or accounts spreading malicious links. Temporary penalties leave a door open for these accounts to return; permanent bans and anti-raid protection are more appropriate. If you want automatic penalties based on warning counts, the progressive penalty system is explained in the AutoMod setup guide.

Frequently asked questions

Does a temporary ban lift right at the exact expiration moment?

Since the scheduler runs every minute, bans are usually lifted within a minute after the expiration time. If the bot happens to be offline at that moment, it will lift them shortly after coming back online.

Can I extend or shorten a timeout duration?

Yes. Simply run the /timeout command again on the same member with the new duration. The new duration starts counting from the moment you run the command, replaces the old one, and opens a new case.

Can I turn a temporary ban into a permanent ban?

Yes, in two steps. First, remove the ban using /unban, then re-ban them without specifying a duration. Since the person is no longer in the server, doing the second step using their user ID in the Web Moderation tab is the easiest way.

Do penalties issued from the panel appear in the log channel?

Yes. Timeouts and bans issued via Web Moderation are logged to the exact same case list and moderation log channel as commands. The person performing the action must have the corresponding permission on Discord; having access to the panel alone is not enough.

Where can I view a penalized member's history?

/case-history displays a member's bans, timeouts, warnings, and notes with pagination. The removal case created at the expiration of a temporary ban will also appear there.

For a general overview of the feature, check the Discord moderation bot page; for all settings, refer to the moderation and audit logs documentation; and for command details, look at the ban, timeout, untimeout, and unban cards.

Last updated: September 26, 2026. The duration formats, limits, and temporary ban lifting behavior described in this article have been verified against VeyroBot's current version of penalty commands, the web moderation panel, and the temporary ban engine.