# Giveaways

All giveaway commands require **Administrator** permission.

**Limits**: 5 active giveaways (free) / 50 active giveaways (premium).

***

## Start a Giveaway

```
/giveaway start <duration> <winners> <prize> [options...]
```

### Required Parameters

| Parameter  | Type                 | Description                                       |
| ---------- | -------------------- | ------------------------------------------------- |
| `duration` | Time string          | Duration of the giveaway (min: 10s, max: 31 days) |
| `winners`  | 1–100                | Number of winners to pick                         |
| `prize`    | Text (max 200 chars) | Prize description                                 |

### Optional Parameters

| Parameter               | Type                   | Description                                                      |
| ----------------------- | ---------------------- | ---------------------------------------------------------------- |
| `description`           | Text (max 1500 chars)  | Giveaway description shown in the embed                          |
| `channel`               | Text channel           | Channel to post the giveaway (default: current channel)          |
| `roles_required`        | Up to 5 roles          | Roles required to enter the giveaway                             |
| `roles_number_required` | 1–999                  | How many of the required roles a user must have                  |
| `roles_blacklist`       | Up to 5 roles          | Roles that cannot enter the giveaway                             |
| `role_bonus_entries`    | `@role amount` pairs   | Bonus entries for specific roles (max 5 roles, 1–1000 entries)   |
| `messages_needed`       | 1–1,000,000            | Minimum messages required to enter                               |
| `joined_age_required`   | Time string            | Minimum time the user must have been in the server               |
| `account_age_required`  | Time string            | Minimum Discord account age                                      |
| `winners_roles`         | Up to 5 roles          | Roles given to winners when the giveaway ends                    |
| :star2: `type`          | `button` or `reaction` | Entry method (default: `button`). `reaction` is **Premium only** |

### Time Format

Use a combination of the following: `1Y 1M 2w 1d 6h 1m 10s`

| Unit | Meaning |
| ---- | ------- |
| `Y`  | Years   |
| `M`  | Months  |
| `w`  | Weeks   |
| `d`  | Days    |
| `h`  | Hours   |
| `m`  | Minutes |
| `s`  | Seconds |

**Example**: `/giveaway start 1d 12h 3 Nitro` — starts a 1 day 12 hours giveaway with 3 winners.

***

## Manage Giveaways

| Command                                 | Description                                            |
| --------------------------------------- | ------------------------------------------------------ |
| `/giveaway end <giveaway>`              | End a running giveaway early and pick winners          |
| `/giveaway reroll <giveaway> [winners]` | Reroll an ended giveaway with new winners              |
| `/giveaway delete <giveaway>`           | Delete a giveaway entirely                             |
| `/giveaway list [ended]`                | List all giveaways. Set `ended: True` to see past ones |

{% hint style="info" %}
The `giveaway` parameter is the **Message ID** of the giveaway message. Right-click the giveaway embed → **Copy Message ID** to get it.
{% endhint %}

***

## Examples

**Simple giveaway:**

```
/giveaway start duration:24h winners:1 prize:Discord Nitro
```

**Giveaway with requirements:**

```
/giveaway start duration:7d winners:2 prize:$50 Gift Card roles_required:@Member messages_needed:100
```

**Giveaway with bonus entries:**

```
/giveaway start duration:3d winners:1 prize:VIP Role role_bonus_entries:@Booster 5 @VIP 3
```