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

# Giveaways

> Run prize draws with entry requirements and automatic winner picking.

## Starting one

<CodeGroup>
  ```javascript Syntax theme={null}
  ,giveaways start (channel) (duration) (winners) (prize)
  ```

  ```javascript Example theme={null}
  ,giveaways start #giveaways 24h 2 Lil Durk Tickets
  ,giveaways start 24h 1 Nitro
  ```
</CodeGroup>

Channel names work as well as mentions. Leave the channel out entirely and the giveaway posts where you ran the command.

Confine adds the 🎉 reaction automatically — that's how members enter.

<Info>
  Winner count is capped at **5**, and prizes at **256 characters**.
</Info>

## Editing a running giveaway

Every edit takes the giveaway's message link so confine knows which one you mean.

### Details

<AccordionGroup>
  <Accordion title="Prize">
    ```javascript theme={null}
    ,giveaways edit prize (message link) Nitro Basic
    ```
  </Accordion>

  <Accordion title="Winner count">
    ```javascript theme={null}
    ,giveaways edit winners (message link) 3
    ```

    Between 1 and 5.
  </Accordion>

  <Accordion title="Host">
    ```javascript theme={null}
    ,giveaways edit host (message link) financely
    ```

    Bots can't be set as host.
  </Accordion>

  <Accordion title="Duration">
    Resets the end time to the duration you give, counted from now.

    ```javascript theme={null}
    ,giveaways edit duration (message link) 2h30m
    ```
  </Accordion>
</AccordionGroup>

### Appearance

<AccordionGroup>
  <Accordion title="Description">
    ```javascript theme={null}
    ,giveaways edit description (message link) Tickets for Saturday's show!
    ```

    Up to 4096 characters.
  </Accordion>

  <Accordion title="Color">
    ```javascript theme={null}
    ,giveaways edit color (message link) #5865F2
    ```
  </Accordion>

  <Accordion title="Image and thumbnail">
    ```javascript theme={null}
    ,giveaways edit image (message link) https://cdn.discordapp.com/...
    ,giveaways edit thumbnail (message link) https://cdn.discordapp.com/...
    ```

    Attaching an image to your command message works too — confine picks it up automatically.

    <Warning>
      Images must be hosted on Discord's CDN. Links from anywhere else are rejected.
    </Warning>
  </Accordion>
</AccordionGroup>

### Entry requirements

Members who don't meet these are filtered out when winners are drawn, even if they reacted.

<AccordionGroup>
  <Accordion title="Required roles">
    Separate several with commas.

    ```javascript theme={null}
    ,giveaways edit requiredroles (message link) @Member, @Booster
    ```
  </Accordion>

  <Accordion title="Level range">
    ```javascript theme={null}
    ,giveaways edit minlevel (message link) 10
    ,giveaways edit maxlevel (message link) 50
    ```

    <Info>
      Uses confine's own [leveling system](/configuration/levels), not another bot's.
    </Info>
  </Accordion>

  <Accordion title="Time in server">
    Requires members to have been in the server a minimum number of days.

    ```javascript theme={null}
    ,giveaways edit stay (message link) 30
    ```

    Between 1 and 30 days.
  </Accordion>
</AccordionGroup>

### Winner reward roles

Roles handed to whoever wins, applied automatically when the giveaway ends.

```javascript theme={null}
,giveaways edit roles (message link) @Winner, @VIP
```

<Info>
  On a reroll, these come off the previous winners before going to the new ones.
</Info>

## Ending early

```javascript theme={null}
,giveaways end (message link)
```

Draws winners immediately instead of waiting for the timer.

## Rerolling

```javascript theme={null}
,giveaways reroll (message link)
```

Drop the message link and confine rerolls your server's most recent giveaway.

<Warning>
  You can't change the winner count during a reroll on an already-ended giveaway. Use `,giveaways edit winners` first, then reroll.
</Warning>

## Listing active giveaways

`,giveaways list` shows every running giveaway with its prize, entry count, and when it ends.