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

# Giveaways

> Host engagement-boosting giveaways with ease.

Host giveaways to reward your members and boost engagement! Zynrax's **Giveaway System** is robust, reliable, and supports custom branding with your own images.

## Hosting a Giveaway

Quickly launch a giveaway in any channel.

### <Icon icon="play" /> Start Giveaway

Launch a giveaway with a specified duration, number of winners, and prize.

<CodeGroup>
  ```bash Syntax theme={null}
  ,gstart (time) (winners) (prize)
  ```

  ```bash Example theme={null}
  ,gstart 24h 3 Nitro Basic
  ```
</CodeGroup>

<Note>
  Time format: `s` (seconds), `m` (minutes), `h` (hours), `d` (days).
</Note>

### <Icon icon="stop" /> End Early

Instantly end a currently running giveaway and pick winners.

<CodeGroup>
  ```bash Syntax theme={null}
  ,gend [message_id]
  ```
</CodeGroup>

<Tip>
  You can also simply **reply** to a giveaway message with `,gend` to end it!
</Tip>

### <Icon icon="rotate" /> Reroll Winners

Pick a new winner for an already ended giveaway.

<CodeGroup>
  ```bash Syntax theme={null}
  ,greroll
  ```
</CodeGroup>

<Note>
  You **must reply** to the ended giveaway message with `,greroll` to pick a new winner.
</Note>

<br />

## Configuration & Branding

Make your giveaways stand out with custom settings.

### <Icon icon="image" /> Custom Embed Image

Set a custom banner image that will appear at the bottom of all giveaway messages.

<CodeGroup>
  ```bash Set Image theme={null}
  ,gembed set (url/upload)
  ```

  ```bash Reset theme={null}
  ,gembed reset
  ```
</CodeGroup>

### <Icon icon="user-gear" /> Giveaway Staff

Allow specific roles to manage giveaways without needing administrator permissions.

<CodeGroup>
  ```bash Set Role theme={null}
  ,gstaff role @GiveawayManager
  ```

  ```bash Reset theme={null}
  ,gstaff reset
  ```
</CodeGroup>

### <Icon icon="gear" /> View Configuration

Check your server's giveaway settings.

<CodeGroup>
  ```bash View All theme={null}
  ,gconfig
  ```
</CodeGroup>

### <Icon icon="list" /> List Giveaways

View all active giveaways in your server.

<CodeGroup>
  ```bash List active theme={null}
  ,glist
  ```
</CodeGroup>