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

# Giveaways

> Run standard and drop giveaways with entry requirements, bonus entries, winner roles and XP rewards. Free on every tier.

<Info>
  **Free on every tier.** Giveaways have no premium gates — the caps below apply to everyone equally.
</Info>

## Six tabs

<CardGroup cols={3}>
  <Card title="Overview" icon="chart-line">
    Participation stats and recent winners.
  </Card>

  <Card title="All Giveaways" icon="list">
    Every giveaway, filterable by status.
  </Card>

  <Card title="Blacklist" icon="ban">
    Members barred from entering.
  </Card>

  <Card title="Logs" icon="scroll">
    Where giveaway events are recorded.
  </Card>

  <Card title="Templates" icon="palette">
    Reusable embed designs.
  </Card>

  <Card title="Settings" icon="sliders">
    Server-wide defaults.
  </Card>
</CardGroup>

## Two types

|           | Standard           | Drop                        |
| --------- | ------------------ | --------------------------- |
| Ends when | The timer runs out | The entry target is reached |
| Winners   | Random draw        | First to enter              |

<Warning>
  **A Drop that never fills up expires after 24 hours**, regardless of the entry target you set. Size the target to something your server will realistically hit within a day.
</Warning>

## Creating one

<Steps>
  <Step title="General">
    Prize and channel.
  </Step>

  <Step title="Configuration">
    Winner count (1–20) and duration for a standard giveaway, or a maximum entry count (up to 10,000) for a drop. Optionally delay the start by a number of hours.
  </Step>

  <Step title="Message">
    A template or a custom embed, and whether members enter with a **button** or a **reaction**.
  </Step>

  <Step title="Requirements">
    Who may enter.
  </Step>

  <Step title="Prize">
    Optionally give winners a role, or XP.
  </Step>
</Steps>

Duration accepts `m`, `h`, `d`, `w` and `mo`. A plain number means hours. The range is **1 minute to 30 days**.

<Note>
  If you choose reaction entry you must pick an emoji, or creation is refused.
</Note>

## Requirements

| Requirement         | Cap                                  |
| ------------------- | ------------------------------------ |
| Required roles      | 10                                   |
| Blocked roles       | 10                                   |
| Bypass roles        | 5                                    |
| Minimum account age | 1–365 days                           |
| Minimum level       | 1–200                                |
| Bonus entry rules   | 10, each granting 1–10 extra entries |

Bypass roles skip every other requirement.

<Note>
  Minimum level uses your [Leveling](/en/engagement/leveling) data. On a server with leveling switched off, nobody will meet it.
</Note>

<Warning>
  A bonus-entry rule with no roles selected is dropped silently when you submit. Check the rule kept its roles after saving.
</Warning>

<Tip>
  A minimum account age of 7 days is the single most effective anti-alt measure. It costs genuine members nothing and stops throwaway accounts entering a hundred times.
</Tip>

## Prizes

Alongside the prize you announce, winners can be given roles (up to 10) and XP (up to 100,000, text or voice).

Winners are DMed automatically. A member with DMs closed is skipped without failing the giveaway.

## How winners are drawn

* **Standard, with bonus entries** — weighted random, so extra entries genuinely improve the odds
* **Standard, without** — a cryptographically random shuffle
* **Drop** — the first entrants, in order

Blacklisted members are filtered out at the moment of the draw, not just at entry.

## Managing a running giveaway

Open a giveaway for **Re-Host**, **Reroll Winners**, **End Giveaway** and **Delete Giveaway**.

<Note>
  Reroll draws fresh winners from the same entries. The original winners keep any role or XP already given.
</Note>

## Blacklist

Up to 500 members with an optional reason. Add, remove and clear-all take effect immediately.

## Templates

Up to 10 reusable designs, each with an active embed, an ended embed and an entry-button style. One can be marked active and becomes the default for new giveaways.

Template variables: `{prize}`, `{winners}`, `{host}`, `{endsAt}`, `{id}`, `{description}`, `{requiredRole}`, `{minAccountAge}`, `{entryCount}`.

## Settings

Two server-wide defaults: a default minimum account age, and whether winners are DMed.

<Note>
  This is the only tab that uses the save bar. Everything else — creating, ending, rerolling, blacklisting, templates — applies immediately.
</Note>

## Caps

|                      |         |
| -------------------- | ------- |
| Active giveaways     | 100     |
| Winners per giveaway | 20      |
| Duration             | 30 days |
| Templates            | 10      |
| Blacklist            | 500     |

## Ping role

<Note>
  The ping role shown on a giveaway's detail page can only be set with the `/gstart` command — there is no control for it in the create form.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Members cannot enter">
    Check the requirements — account age and level catch more people than expected. Vetox also needs to be able to see and post in the channel, and to add the reaction if you chose reaction entry.
  </Accordion>

  <Accordion title="The giveaway ended but no winner was announced">
    Nobody eligible entered, or every entrant was blacklisted by draw time. Reroll after resolving it.
  </Accordion>

  <Accordion title="A drop ended early with nobody winning">
    Drops expire after 24 hours if the entry target is not reached. Lower the target.
  </Accordion>

  <Accordion title="Winners did not get their role">
    The role must sit **below** Vetox and Vetox needs **Manage Roles**.
  </Accordion>

  <Accordion title="I cannot create another giveaway">
    You are at 100 active. End or delete some.
  </Accordion>
</AccordionGroup>

<Card title="Battle Pass" icon="trophy" horizontal href="/en/engagement/battle-pass">
  Ongoing rewards rather than one-off prizes.
</Card>