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

# Giveaways

<Card title="Module: Giveaways" icon="party-horn" horizontal="True">
  Setup giveaways for your server members to receive prizes!
</Card>

## Starting a giveaway

<Tabs />

You can start a giveaway using the `giveaway create` command.

<CodeGroup>
  ```javascript syntax theme={null}
  ,giveaway create (flags)
  ```

  ```javascript example theme={null}
  ,giveaway create --prize premium --duration 1h --winners 1
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/I5vQIDwxulOEOE4L/images/gw-cr.png?fit=max&auto=format&n=I5vQIDwxulOEOE4L&q=85&s=0fb52509dfd69d1adb8393e91ee8329f" width="382" height="250" data-path="images/gw-cr.png" />
</Frame>

## Rerolling a giveaway

<Tabs />

To redraw the winner(s) of a giveaway, run the `giveaway reroll` command.

<CodeGroup>
  ```javascript syntax theme={null}
  ,giveaway reroll (message)
  ```

  ```javascript example theme={null}
  ,giveaway reroll 1271474528354045972
  ```
</CodeGroup>

## Ending a giveaway

<Tabs />

To end a giveaway early, run the `giveaway end` command.

<CodeGroup>
  ```javascript syntax theme={null}
  ,giveaway end (message)
  ```

  ```javascript example theme={null}
  ,giveaway end 1271474528354045972
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/I5vQIDwxulOEOE4L/images/gw-end.png?fit=max&auto=format&n=I5vQIDwxulOEOE4L&q=85&s=0052975d29f48a8c19bd55b980068736" width="466" height="128" data-path="images/gw-end.png" />
</Frame>

## Viewing the active giveaways

<Tabs />

<CodeGroup>
  ```javascript syntax theme={null}
  ,giveaway list
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/kyos-c60486ad/I5vQIDwxulOEOE4L/images/gw-list.png?fit=max&auto=format&n=I5vQIDwxulOEOE4L&q=85&s=ed948957c5265a129a722bc5e103dc52" width="352" height="162" data-path="images/gw-list.png" />
</Frame>

## Flags

1. **`--winners`** - Amount of winners the giveaway outputs
2. **`--ping`** - Using this on it's own will ping @here
3. **`--duration`** - How long the giveaway should last
4. **`--prize`** - The prize of the giveaway