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

# Giveaways

> Host engaging giveaways with advanced requirements.

Boost engagement by hosting giveaways. Flamey supports advanced entry requirements, templates, and automated rerolls.

## Hosting a Giveaway

<Tabs>
  <Tab title="Interactive Wizard (Recommended)">
    Run `/giveaway create` to start the setup wizard.

    <Steps>
      <Step title="Prize & Winners">
        Enter the prize name and number of winners.
      </Step>

      <Step title="Duration">
        Set how long the giveaway lasts (e.g., `24h`, `3d`).
      </Step>

      <Step title="Requirements (Optional)">
        Add requirements entrants must meet:

        * **Role:** Must have a specific role (e.g., "Level 10").
        * **Message Count:** Must have sent X messages.
        * **Server Join:** Must be in a partnered server.
      </Step>

      <Step title="Confirm">
        Preview and start the giveaway!
      </Step>
    </Steps>
  </Tab>

  <Tab title="Quick Start">
    For simple, no-requirement giveaways, use the one-line command:

    ```bash theme={null}
    /giveaway start duration:1h winners:1 prize:1 Month Discord Nitro
    ```
  </Tab>
</Tabs>

## Management Commands

<CardGroup cols={2}>
  <Card title="Reroll" icon="shuffle">
    `/giveaway reroll [message_id]`
    Pick a new winner if the previous one didn't claim the prize.
  </Card>

  <Card title="End Early" icon="stopwatch">
    `/giveaway end [message_id]`
    Stop the giveaway immediately and pick winners.
  </Card>

  <Card title="List" icon="list-ol">
    `/giveaway list`
    Show all currently active giveaways in the server.
  </Card>

  <Card title="Edit" icon="pen">
    `/giveaway edit [message_id]`
    Change the prize, winners, or duration of an active giveaway.
  </Card>
</CardGroup>

## Templates

Save your frequently used giveaway settings (like requirements and messages) as **Templates** to reuse them instantly.

<CodeGroup>
  ```bash Create Template theme={null}
  /giveaway template create
  # Follow the wizard to save your settings
  ```

  ```bash Use Template theme={null}
  /giveaway create template:MyWeeklyDrop
  # Loads your saved template automatically
  ```
</CodeGroup>