> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Moderation tools

> Review and lift active bans, mutes, timeouts and temporary roles from the dashboard. Free on every tier.

Moderation Tools shows punishments currently in force in your server, and lets you lift them.

<Info>
  Free on every tier.
</Info>

<Note>
  This page is for **reviewing and undoing** punishments. You cannot issue a new ban, mute or timeout here — those are applied with [slash commands](/en/commands/moderation) in Discord.
</Note>

## The four tabs

<Tabs>
  <Tab title="Bans">
    Everyone currently banned, with the reason and expiry. Permanent bans are labelled as such.

    Action: **Unban**.
  </Tab>

  <Tab title="Mutes">
    Active mutes, each marked **Text** or **Voice**.

    Action: **Unmute**.
  </Tab>

  <Tab title="Timeouts">
    <Warning>
      **This tab is always empty.** Discord manages timeouts natively and Vetox does not track them, so there is nothing for this tab to list — regardless of how many members are currently timed out.

      To remove a timeout, use `/untimeout` in Discord.
    </Warning>
  </Tab>

  <Tab title="Temp Roles">
    Temporary roles that have not yet expired.

    Actions: **Edit** the remaining duration, or **End** it immediately.
  </Tab>
</Tabs>

A search box filters by username or ID.

<Note>
  Search filters only the entries already loaded. It does not query your full history.
</Note>

## Editing a temporary role

Set a **New Duration** in minutes and optionally a reason. The new expiry must be in the future.

<Note>
  If you leave the duration blank or enter zero, the dialog does nothing at all — no error, no confirmation. Enter a positive number.
</Note>

## How lifting a punishment works

<Steps>
  <Step title="You confirm the action">
    The dashboard asks the bot to perform it in Discord.
  </Step>

  <Step title="The bot performs it and confirms">
    Only once Discord confirms is the record cleared.
  </Step>

  <Step title="If anything fails, the record stays">
    A failure or timeout leaves the entry visible so you can retry. The dashboard never shows a punishment as lifted while it is still in force.
  </Step>
</Steps>

<Warning>
  **After an unban, unmute or timeout removal, all four tabs may appear empty for about a minute.** This is a display bug — the table has lost its data, not your server.

  Your action succeeded. Reload the page to see the correct list again.
</Warning>

## Things worth knowing

<AccordionGroup>
  <Accordion title="The confirmation button says Delete" icon="triangle-exclamation">
    The confirm dialog for unban, unmute and timeout removal uses a generic **Delete** label. It still performs the action described in the dialog text — read the description rather than the button.
  </Accordion>

  <Accordion title="Temporary punishments are capped at 30 days" icon="clock">
    Anything longer must be issued as a permanent action.
  </Accordion>

  <Accordion title="Unmuting someone with no active mute" icon="circle-question">
    The action reports a generic failure rather than explaining that there was nothing to remove.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Moderation commands" icon="terminal" href="/en/commands/moderation">
    Where bans, mutes, timeouts and warnings are issued.
  </Card>

  <Card title="Logging" icon="scroll" href="/en/moderation/logs">
    A permanent record of moderation activity.
  </Card>
</CardGroup>