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

# Giveaways

> Host engaging giveaways with modern Discord UI components.

## Overview

Flare's Giveaway module lets you host giveaways with automatic timer countdowns, participant tracking, and winner selection — all using modern Discord V2 Container components for a sleek, visual experience.

***

## Commands

| Command                                | Description                          | Permission     |
| -------------------------------------- | ------------------------------------ | -------------- |
| `/gstart <duration> <winners> <prize>` | Start a new giveaway                 | `Manage Guild` |
| `/gend <message_id>`                   | End a giveaway early                 | `Manage Guild` |
| `/greroll <message_id>`                | Reroll winners for an ended giveaway | `Manage Guild` |

**Aliases:** `gstart` → `startgw`, `gcreate`

***

## Creating a Giveaway

```bash theme={null}
/gstart 12h 1 Nitro
/gstart 2d 3 Nitro Basic
```

### Parameters

* **Duration:** Supports `s` (seconds), `m` (minutes), `h` (hours), `d` (days). Maximum: **30 days**.
* **Winners:** Number of winners (1–10).
* **Prize:** The prize name (max 256 characters).

### What Happens

1. Flare creates a beautifully styled Container message in the current channel.
2. A 🎉 button appears for users to enter the giveaway.
3. When the timer expires, Flare automatically selects random winners and announces them.

***

## Ending & Rerolling

<Tabs>
  <Tab title="End Early">
    If you need to end a giveaway before the timer runs out:

    ```bash theme={null}
    /gend <message_id>
    ```
  </Tab>

  <Tab title="Reroll Winners">
    If a winner doesn't claim their prize, reroll to pick a new one:

    ```bash theme={null}
    /greroll <message_id>
    ```
  </Tab>
</Tabs>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="The giveaway button says 'Interaction Failed'">
    Flare may have lost permissions in the channel since the giveaway was created. Ensure Flare has `Send Messages` and `View Channel` permissions.
  </Accordion>

  <Accordion title="No winners were selected">
    This happens when zero participants entered the giveaway. Flare will announce "Not enough participants" instead of a winner.
  </Accordion>
</AccordionGroup>

## Related Pages

* [Giveaway Commands](/commands/giveaway)