> ## Documentation Index
> Fetch the complete documentation index at: https://docs.misery.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

```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
```

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

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

> [!NOTE]
>
> Requires **Manage Channels**. Winner count is capped at **5**, and prizes at **256 characters**. `,gw` works in place of `,giveaways`.

## Editing a giveaway

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

### Details

> **Prize**
>
> ```javascript theme={null}
> ,giveaways edit prize (message link) Nitro Basic
> ```

> **Winner count**
>
> ```javascript theme={null}
> ,giveaways edit winners (message link) 3
> ```
>
> Between 1 and 5. On an ended giveaway this only takes effect on the next reroll.

> **Host**
>
> ```javascript theme={null}
> ,giveaways edit host (message link) financely
> ```
>
> Bots can't be set as host.

> **Duration**
>
> Resets the end time to the duration you give, counted from now.
>
> ```javascript theme={null}
> ,giveaways edit duration (message link) 2h30m
> ```
>
> Or add days on top of the current end time:
>
> ```javascript theme={null}
> ,giveaways edit age (message link) 2
> ```

### Appearance

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

> **Color**
>
> ```javascript theme={null}
> ,giveaways edit color (message link) #5865F2
> ```

> **Image and thumbnail**
>
> ```javascript theme={null}
> ,giveaways edit image (message link) https://fluxerusercontent.com/...
> ,giveaways edit thumbnail (message link) https://fluxerusercontent.com/...
> ```
>
> > [!WARNING]
> >
> > Images must be hosted on Fluxer. Links from anywhere else are rejected.

### Entry requirements

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

> [!NOTE]
>
> Requirements can only be changed **before** a giveaway ends. Use `none` to remove one.

> **Required roles**
>
> Separate several with commas.
>
> ```javascript theme={null}
> ,giveaways edit requiredroles (message link) @Member, @Supporter
> ```

> **Level range**
>
> ```javascript theme={null}
> ,giveaways edit minlevel (message link) 10
> ,giveaways edit maxlevel (message link) 50
> ```
>
> > [!NOTE]
> >
> > Uses misery's own [leveling system](/engagement/levels), and only while levels are turned on.

> **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
> ```

### Winner reward roles

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

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

> [!NOTE]
>
> On a reroll, these come off the previous winners before going to the new ones. Roles with dangerous permissions can't be rewards.

## 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 misery rerolls your server's most recently ended giveaway. Rerolls are possible for a day after a giveaway ends.

## Listing active giveaways

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.