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

# Giveaways

> Engage your community with automated prize giveaways and winner selection.

# Giveaways

Veronica's **Giveaway** system makes it easy to host events and reward your community. With support for multiple winners, custom durations, and interactive entry buttons, hosting a giveaway has never been simpler.

## Creating a Giveaway

Use the `/giveaway` command to launch your event instantly.

<Steps title="Giveaway Launch Workflow">
  <Step title="Run the Command">
    Specify the duration, number of winners, and the prize.

    ```bash theme={null}
    /giveaway duration:2h winners:3 prize:Discord Nitro
    ```

    <Check>Giveaway successfully initialized and broadcast.</Check>
  </Step>

  <Step title="Interactive Entry">
    Veronica will post a giveaway embed with an **Enter Giveaway** button.
    <Check>Members can now join via one-click interactions.</Check>
  </Step>

  <Step title="Automated Selection">
    Once the duration expires, Veronica will automatically select the winners.
    <Check>Winner announcement broadcast to the channel.</Check>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Sticky Messages" icon="anchor" href="/setups/stickymessage">
    Use stickies to keep the giveaway rules visible at the bottom of the chat.
  </Card>

  <Card title="Command Reference" icon="list-ol" href="/resources/commands">
    Explore more engagement commands in the full reference.
  </Card>
</CardGroup>

## Command Syntax

### Slash Command

```bash theme={null}
/giveaway duration:[amount][unit] winners:[number] prize:[text]
```

**Duration Units:**

* `m`: minutes (e.g., `10m`)
* `h`: hours (e.g., `1h`)
* `d`: days (e.g., `7d`)

### Prefix Command

```bash theme={null}
,giveaway <duration> <winners> <prize>
```

<Note>
  Prefix giveaways use **reactions** (🎉) for entries instead of buttons, ensuring compatibility with all message types.
</Note>

## Features & Logic

* **Winner Selection:** Winners are chosen using a cryptographically secure random number generator to ensure fairness.
* **Entry Tracking:** Members can only enter once. Veronica tracks participants by their Discord ID.
* **Dynamic Updates:** The giveaway embed updates in real-time to show the remaining time and the number of entries.
* **Host Info:** Every giveaway clearly displays the host (the user who ran the command) and a unique Giveaway ID for tracking.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Giveaway Ended Early">
    Giveaways may end prematurely if the bot is restarted or if the host manually deletes the message.
  </Accordion>

  <Accordion title="No Winners Selected">
    If no members enter by the time the duration expires, Veronica will announce that the giveaway has expired without winners.
  </Accordion>

  <Accordion title="Permission Denied">
    Ensure Veronica has **Send Messages** and **Embed Links** permissions in the giveaway channel.
  </Accordion>
</AccordionGroup>

<Tip>
  Set a longer duration for high-value prizes to give more members a chance to participate!
</Tip>