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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.invite-count.xyz/commands/giveaways.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.