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

# Giveaway

> Run giveaways with entry requirements, bonus roles, and scheduled starts.

# Giveaway

> Run giveaways with entry requirements, bonus roles, and scheduled starts.

## Create a giveaway

```bash theme={null} theme={null}
;giveaway create (#channel) (duration) (winners) (prize) [flags]
```

```bash theme={null} theme={null}
;gw create #giveaways 1d 3 Discord Nitro
```

```bash theme={null} theme={null}
;gw create #giveaways 2h 1 Steam Gift Card --role @Members --dm
```

Duration accepts standard time formats: `1h`, `2d`, `30m`, `1d12h`, etc.

**Available flags**

| Flag                    | Description                                 |
| ----------------------- | ------------------------------------------- |
| `--role @role`          | Require members to have this role to win    |
| `--bonus @role`         | Members with this role get extra entries    |
| `--messages N`          | Require N messages sent in the server       |
| `--level N`             | Require level N or above                    |
| `--invites N`           | Require N invites                           |
| `--ignore @role`        | Exclude members with this role from winning |
| `--dm`                  | DM winners when the giveaway ends           |
| `--schedule <duration>` | Delay the start by this amount of time      |

<Info>
  Requirements are enforced at pick time. All entries are collected first, then winners are filtered against every requirement. A giveaway with strict requirements may result in fewer winners than specified.
</Info>

## Manage

<Tabs>
  <Tab title="End early">
    End a running giveaway immediately and pick winners from current entries.

    ```bash theme={null} theme={null}
    ;gw end (message link)
    ```

    ```bash theme={null} theme={null}
    ;gw end https://discord.com/channels/.../...
    ```
  </Tab>

  <Tab title="Reroll">
    Pick new winners for an ended giveaway. Defaults to 1 winner if not specified.

    ```bash theme={null} theme={null}
    ;gw reroll (message link) [winners]
    ```

    ```bash theme={null} theme={null}
    ;gw reroll https://discord.com/channels/.../...
    ```

    ```bash theme={null} theme={null}
    ;gw reroll https://discord.com/channels/.../... 3
    ```
  </Tab>

  <Tab title="Delete">
    Permanently delete a giveaway and its embed.

    ```bash theme={null} theme={null}
    ;gw delete (message link)
    ```

    ```bash theme={null} theme={null}
    ;gw delete https://discord.com/channels/.../...
    ```
  </Tab>

  <Tab title="List">
    View all giveaways in the server — active, scheduled, and ended.

    ```bash theme={null} theme={null}
    ;gw list
    ```
  </Tab>
</Tabs>

## Edit

<AccordionGroup>
  <Accordion title="Edit duration">
    Change how long a giveaway runs. The timer resets to the new value from now.

    ```bash theme={null} theme={null}
    ;gw edit duration (message link) (new duration)
    ```

    ```bash theme={null} theme={null}
    ;gw edit duration https://discord.com/channels/.../... 2d
    ```
  </Accordion>

  <Accordion title="Edit host">
    Transfer host attribution to another member.

    ```bash theme={null} theme={null}
    ;gw edit host (message link) (@member)
    ```

    ```bash theme={null} theme={null}
    ;gw edit host https://discord.com/channels/.../... @wanderer
    ```
  </Accordion>

  <Accordion title="Edit prize">
    Update the prize text shown in the embed.

    ```bash theme={null} theme={null}
    ;gw edit price (message link) (new prize)
    ```

    ```bash theme={null} theme={null}
    ;gw edit price https://discord.com/channels/.../... 3 Months of Nitro
    ```
  </Accordion>

  <Accordion title="Edit winner count">
    Change how many winners will be picked when the giveaway ends.

    ```bash theme={null} theme={null}
    ;gw edit winners (message link) (number)
    ```

    ```bash theme={null} theme={null}
    ;gw edit winners https://discord.com/channels/.../... 5
    ```
  </Accordion>
</AccordionGroup>

## Requirements

Manage entry requirements on a live giveaway. Valid requirement names: `role`, `bonus`, `ignore`, `messages`, `level`.

<Tabs>
  <Tab title="Add">
    Attach a requirement to a running giveaway.

    ```bash theme={null} theme={null}
    ;gw requirements add (message link) (requirement) (value)
    ```

    ```bash theme={null} theme={null}
    ;gw requirements add https://discord.com/channels/.../... role 123456789
    ```

    ```bash theme={null} theme={null}
    ;gw requirements add https://discord.com/channels/.../... messages 100
    ```
  </Tab>

  <Tab title="Edit">
    Update the value of an existing requirement.

    ```bash theme={null} theme={null}
    ;gw requirements edit (message link) (requirement) (new value)
    ```

    ```bash theme={null} theme={null}
    ;gw requirements edit https://discord.com/channels/.../... level 10
    ```
  </Tab>

  <Tab title="Remove">
    Remove a requirement from the giveaway.

    ```bash theme={null} theme={null}
    ;gw requirements remove (message link) (requirement)
    ```

    ```bash theme={null} theme={null}
    ;gw requirements remove https://discord.com/channels/.../... role
    ```
  </Tab>
</Tabs>