Skip to content

Untimeout

The untimeout command (also available as unmute) allows server moderators to lift an active Discord timeout from a member before it naturally expires. This restores the member's ability to send messages and participate in the community immediately.

Syntax

The untimeout command can be used in two ways:

Slash Command:

Text Only
/untimeout member:@user [reason:STRING] [silent:true/false]

Prefix Command:

Text Only
$untimeout @user [reason] [-silent]

Aliases:

  • uto
  • unmute

Parameters

Parameter Type Required Description
member Member Yes The member to remove the timeout from.

Flags

This command supports the following flags:

Flag Type Default Description
reason String No reason provided The reason for removing the timeout (positional).
-silent Boolean False If true, Tux will not attempt to DM the user.

reason

The reason for lifting the timeout early, logged in the moderation case and included in the DM notification. In the prefix command, this is a positional flag.

  • Type: String
  • Default: "No reason provided"

-silent

Whether to suppress the DM notification to the user being untimed out.

  • Type: Boolean
  • Default: False
  • Aliases: -s, -quiet

Permissions

Bot Permissions

Tux requires the following permissions:

  • Moderate Members - Required to remove the Discord timeout.

User Permissions

Users need appropriate moderation permissions to use this command.

Permission System

Command permissions are configured per-guild using Tux's dynamic permission system. Configure via /config commands or see the Permission Configuration guide.

Usage Examples

Basic Untimeout (Slash)

Removing a timeout from a member.

Text Only
/untimeout member:@user reason:"Manual release"

With Reason (Slash)

Text Only
/untimeout member:@user reason:"Good behavior"

With Reason

Text Only
$untimeout @user Early release after appeal

Response

When executed successfully, Tux will:

  1. Attempt to DM the user stating their timeout has been lifted (unless -silent is used).
  2. Remove the official Discord timeout restriction.
  3. Create a new moderation case in the database.
  4. Post a confirmation message in the current channel.
  5. Log the action in the designated moderation log channel.

Error Handling

Common Errors

Error: Missing Permissions / Higher Role

When it occurs: Tux lacks the "Moderate Members" permission, or the target user's role is higher than Tux's role.

Solution: Ensure Tux has the "Moderate Members" permission. Move Tux's role higher in the hierarchy.

Error: Lacking Permission Rank

When it occurs: Your internal Tux permission rank is lower than the rank required to use this command.

Solution: Contact a server administrator to check your rank.

Error: User Not Timed Out

When it occurs: You attempt to untimeout a member who does not have an active timeout.

Solution: No action needed.

Error: Member Not Found

When it occurs: The provided mention or ID is invalid.

Solution: Ensure you are mentioning a valid member currently in the guild.

  • /timeout - Apply a temporary restriction to a member.
  • /cases - View moderation history.