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

# Giveaways

> Create, manage, customize, edit, and host giveaways with role requirements and manager delegations.

# Giveaway System

<Badge variant="elite">Tier 1: Elite</Badge>

> Host seamless giveaways in your server with customizable templates, required role gates, live editing, manager roles, and participant blacklists.

***

## Commands Overview

| Command     | Aliases                      | Syntax                                           | Description                               | Permissions    |
| :---------- | :--------------------------- | :----------------------------------------------- | :---------------------------------------- | :------------- |
| `.gstart`   | `giveawaystart`, `gcreate`   | `.gstart <duration> <winners> <prize> [channel]` | Starts a new giveaway.                    | Administrator  |
| `.gend`     | `giveawayend`                | `.gend <message_id>`                             | Ends an active giveaway immediately.      | Administrator  |
| `.greroll`  | `giveawayreroll`             | `.greroll <message_id> [winner_count]`           | Rerolls winners for an ended giveaway.    | Administrator  |
| `.gsetup`   | `giveawaysetup`              | `.gsetup <subcommand> [args]`                    | Configures default giveaway styling.      | Administrator  |
| `.gedit`    | `giveawayedit`               | `.gedit <subcommand> <message_id> <value>`       | Edits active giveaway parameters.         | None / Manager |
| `.gmanager` | `giveawaymanager`, `gmanage` | `.gmanager <subcommand> [@role]`                 | Manages the giveaway manager role.        | Administrator  |
| `.gallow`   | `gpermit`, `grole`           | `.gallow <message_id> <@role\|role_id>`          | Sets a required role to enter a giveaway. | Administrator  |
| `.gban`     | `giveawayban`                | `.gban <subcommand> [target]`                    | Bans users or roles from giveaways.       | Administrator  |
| `.glist`    | `giveawaylist`               | `.glist`                                         | Lists all active server giveaways.        | None           |

***

## Starting & Ending Giveaways

### gstart

Launch a new giveaway in the current channel or a specified channel.

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    .gstart <duration> <winners> <prize> [channel]
    ```
  </Tab>

  <Tab title="Examples">
    ```bash theme={null} theme={null}
    .gstart 1h 2 Nitro Boost
    .gstart 7d 1 Discord Nitro #giveaways
    .gstart 30m 5 VIP Role #announcements
    ```
  </Tab>
</Tabs>

* **Aliases**: `giveawaystart`, `gcreate`
* **User Permissions**: Administrator / Giveaway Manager

***

### gend

Instantly conclude an active giveaway and pick the winners ahead of schedule.

```bash theme={null} theme={null}
.gend 1461440639311806724
```

* **Aliases**: `giveawayend`

***

### greroll

Select new random winner(s) from eligible entrants for an ended giveaway message.

<Tabs>
  <Tab title="Syntax">
    ```bash theme={null} theme={null}
    .greroll <message_id> [winner_count]
    ```
  </Tab>

  <Tab title="Example">
    ```bash theme={null} theme={null}
    .greroll 1461440639311806724 2
    ```
  </Tab>
</Tabs>

* **Aliases**: `giveawayreroll`

***

### glist

View a paginated list of all active giveaways currently running in your server.

```bash theme={null} theme={null}
.glist
```

* **Aliases**: `giveawaylist`

***

## Giveaway Configuration & Setup

### gsetup

Configure default appearance, branding, colors, and emojis for all future giveaways.

| Subcommand  | Syntax                                  | Description                                | Example                                          |
| :---------- | :-------------------------------------- | :----------------------------------------- | :----------------------------------------------- |
| `thumbnail` | `.gsetup thumbnail <url or attachment>` | Sets default giveaway embed thumbnail      | `.gsetup thumbnail https://example.com/logo.png` |
| `image`     | `.gsetup image <url or attachment>`     | Sets default giveaway embed banner image   | `.gsetup image https://example.com/banner.png`   |
| `color`     | `.gsetup color <hex code>`              | Sets default embed hex color               | `.gsetup color #FF5733`                          |
| `emoji`     | `.gsetup emoji <emoji>`                 | Sets default entry reaction emoji          | `.gsetup emoji 🎉`                               |
| `reset`     | `.gsetup reset`                         | Resets all giveaway settings to default    | `.gsetup reset`                                  |
| `view`      | `.gsetup view`                          | Displays the current default configuration | `.gsetup view`                                   |

***

## Live Giveaway Editing

### gedit

Modify properties of an ongoing giveaway in real-time without restarting or resetting entrants.

| Subcommand  | Syntax                                     | Description                       | Example                                                              |
| :---------- | :----------------------------------------- | :-------------------------------- | :------------------------------------------------------------------- |
| `thumbnail` | `.gedit thumbnail <message_id> <url>`      | Updates giveaway thumbnail        | `.gedit thumbnail 1461440639311806724 https://example.com/image.png` |
| `image`     | `.gedit image <message_id> <url>`          | Updates giveaway banner image     | `.gedit image 1461440639311806724 https://example.com/banner.png`    |
| `color`     | `.gedit color <message_id> <hex code>`     | Updates embed color               | `.gedit color 1461440639311806724 #ffffff`                           |
| `host`      | `.gedit host <message_id> <@user\|userId>` | Changes the giveaway host         | `.gedit host 1461440639311806724 @newhost`                           |
| `duration`  | `.gedit duration <message_id> <time>`      | Extends or updates remaining time | `.gedit duration 1461440639311806724 7d`                             |
| `prize`     | `.gedit prize <message_id> <prize>`        | Changes the prize text            | `.gedit prize 1461440639311806724 1 Year Nitro`                      |

***

## Role Requirements & Management

### gallow

Restrict entry to members holding a specific required role.

```bash theme={null} theme={null}
.gallow 1461440639311806724 @Nitro
```

* **Aliases**: `gpermit`, `grole`

***

### gmanager

Set or reset the role whose holders are permitted to start, end, and edit giveaways without requiring full Administrator permissions.

<Tabs>
  <Tab title="Set Manager">
    ```bash theme={null} theme={null}
    .gmanager set @GiveawayManagers
    ```
  </Tab>

  <Tab title="Reset">
    ```bash theme={null} theme={null}
    .gmanager reset
    ```
  </Tab>

  <Tab title="Config">
    ```bash theme={null} theme={null}
    .gmanager config
    ```
  </Tab>
</Tabs>

* **Aliases**: `giveawaymanager`, `gmanage`

***

### gban

Prevent specific users or roles from entering or winning giveaways.

| Subcommand | Syntax                                         | Example              |
| :--------- | :--------------------------------------------- | :------------------- |
| `add`      | `.gban add <@user\|userId / @role\|roleId>`    | `.gban add @user`    |
| `remove`   | `.gban remove <@user\|userId / @role\|roleId>` | `.gban remove @user` |
| `list`     | `.gban list`                                   | `.gban list`         |