> ## 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.

# Troubleshooting

> Diagnose problems in order — the checks that resolve the overwhelming majority of Vetox issues.

Work through these in order. The first three resolve most reports.

## The first three checks

<Steps>
  <Step title="Is the module switched on?">
    Most features are **off by default**. Configuring a feature's own page does nothing until its switch is on in [Server Setup](/en/server-management/setup).

    This is the single most common cause of "I set it up and nothing happened".
  </Step>

  <Step title="Is the Vetox role high enough?">
    For anything touching roles or members, **the Vetox role must sit above the target's highest role**. Drag it up in Server Settings → Roles.

    Discord refuses these actions regardless of permissions, and several parts of Vetox fail **silently** when this is wrong — Tickets in particular gives no error at all.
  </Step>

  <Step title="Does Vetox have the channel permission?">
    Check the bot's *effective* permissions in the specific channel, not its server-wide role. **Embed Links** is the one most often missing.
  </Step>
</Steps>

## By symptom

<AccordionGroup>
  <Accordion title="Auto-Moderation is not filtering anything" icon="filter">
    1. All eight rules ship **disabled** — turn on the ones you want
    2. **Administrators are never filtered.** Test with a normal account
    3. Only the first matching rule fires per message
    4. Check the rule's own disabled channels and roles
    5. If any Automated Action exists, rule-level timeouts are suppressed everywhere
  </Accordion>

  <Accordion title="Notifications never arrive" icon="bell">
    1. The platform's toggle in **Server Setup** — off by default, and the notifications page does not show its state
    2. Active **Basic** premium or higher
    3. **Embed Links** in the target channel
    4. On Twitch and Kick, adding a streamer who is already live announces nothing until their next stream
    5. Anything published while premium was lapsed is marked seen and will not replay
  </Accordion>

  <Accordion title="Roles are not being assigned" icon="user-tag">
    1. The role must be **below** the Vetox role
    2. Vetox needs **Manage Roles**
    3. Vetox refuses to grant any role holding Administrator, Manage Server or Manage Roles as a reward — this cannot be overridden
    4. On a reward-role row with no role selected, the row is silently dropped on save
  </Accordion>

  <Accordion title="Staff cannot see or act in tickets" icon="ticket">
    Almost always **role hierarchy**. Move the Vetox role above every support role.

    Ticket permission failures produce no error, no log entry and no visible symptom other than staff being unable to act.
  </Accordion>

  <Accordion title="An embed field keeps disappearing" icon="rectangle-list">
    Its title or value resolved to empty, and empty fields are dropped. Nearly always a misspelled variable or one that does not exist for that feature — check [Variables](/en/help/variables).
  </Accordion>

  <Accordion title="A setting saved but did not take effect" icon="floppy-disk">
    Configuration normally reaches the bot within seconds. If the notification is missed, the bot keeps the old value until its cache expires — **up to about 10 minutes**.

    Wait ten minutes before re-saving.
  </Accordion>

  <Accordion title="Members are not gaining XP" icon="chart-line">
    1. Leveling switched on in Server Setup
    2. The channel is not excluded, and the member holds no excluded role
    3. On **Starter**, the text/voice/reaction on-off switches do not take effect — the bot uses standard rates regardless
  </Accordion>

  <Accordion title="Welcome messages are not posting" icon="hand-wave">
    1. Welcomer on in Server Setup, a channel set, the message switch on
    2. **Attach Files** for the image
    3. If `[Server]` appears literally, change it to `[ServerName]`
    4. If your embed keeps reverting, the message type must be set to **Embed** when you save
  </Accordion>

  <Accordion title="An application cannot be submitted" icon="clipboard-list">
    A dialog form with more than 5 questions where a later one is required can **never** be submitted — Discord shows 5 fields but the 6th is still validated.

    Switch to the Private Message flow, or make questions 6+ optional.
  </Accordion>

  <Accordion title="A command does not appear" icon="terminal">
    1. Every command is **guild-only** — none work in DMs
    2. It may be disabled or restricted on the [Commands](/en/server-management/command-management) page
    3. Restart your Discord client to refresh the command list
  </Accordion>

  <Accordion title="AI features stopped working" icon="sparkles">
    Check the token balance on [AI Usage](/en/moderation/ai-usage).

    Auto-Mod stops below 3,000 tokens; Server Control declines below 30,000. Auto-Mod is fail-closed — if it cannot confirm budget, it does not scan.
  </Accordion>

  <Accordion title="AI Server Control ignores me completely" icon="wand-magic-sparkles">
    Silence is the normal response to every access failure. In order:

    1. Mention the bot **directly** — a role ping or reply ping is not a trigger
    2. AI Server Control on in Server Setup
    3. The channel is in scope
    4. You are an Administrator, **or** on an allowlist with *Allowlist bypasses Administrator* turned on — the allowlists do nothing by themselves
    5. You are not rate-limited
  </Accordion>

  <Accordion title="A purchase has not applied" icon="credit-card">
    It normally applies within a second. Wait about 15 minutes, then contact support — **do not buy again**.
  </Accordion>

  <Accordion title="Data disappeared after downgrading" icon="triangle-exclamation">
    Nine categories are permanently deleted rather than disabled — most importantly **application questions above the new limit**. See [Feature limits](/en/premium/feature-limits).
  </Accordion>

  <Accordion title="A scheduled thing fires at the wrong time" icon="clock">
    Check the **Server Timezone** in Server Setup — it drives streaks, resets and scheduled actions.

    Reminders are the exception: they capture the timezone of the browser they were created in, and there is no control for it.
  </Accordion>
</AccordionGroup>

## Things that look broken but are not

<Note>
  | Behaviour                                              | Why                                       |
  | ------------------------------------------------------ | ----------------------------------------- |
  | Administrators bypass Auto-Moderation                  | By design, and not shown in the interface |
  | Only one Auto-Mod rule fires per message               | By design — first match wins              |
  | A streamer added mid-stream produces nothing           | Live tracking fires on the transition     |
  | Your Vito rank lags your balance                       | Leaderboards recalculate every 12 hours   |
  | A one-off reminder stays in the list after firing      | Kept as a record, marked completed        |
  | Seven Server Setup cards flash "Enabled" on first load | Cosmetic; the Disabled state is truthful  |
  | `/move` with no user moves you                         | The option defaults to the caller         |
</Note>

## Still stuck

<CardGroup cols={2}>
  <Card title="Support server" icon="discord" href="https://discord.gg/vetox">
    Ask in the Vetox Discord.
  </Card>

  <Card title="I Need Help" icon="life-ring" href="/en/server-management/support-sessions">
    Let an agent see your dashboard live.
  </Card>
</CardGroup>