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

# Quickstart

> Invite GiveawayX and run your first giveaway in about a minute.

**1. Add the bot to your server**

Run `/invite` in any server that already has GiveawayX to get the invite link, or ask in the [support server](https://discord.gg/86jArY28hj). When the bot joins it posts a **Getting Started** message where admins can confirm the server language and prefix.

**2. Let the bot see the channel**

In the channel for your giveaways, make sure the bot can **View Channel** and **Send Messages**. Reaction giveaways also need **Add Reactions**. The full list is in [Permissions](https://docs.giveawayx.lol/concepts/permissions.md).

**3. Start a giveaway**

Pick whichever style you like:

```text Form (easiest) theme={"system"}
/gcreate
```

```text One command theme={"system"}
/gstart duration:1d winners:1 prize:Discord Nitro
```

```text Prefix theme={"system"}
g!gstart --duration=1d --winners=1 --prize=Discord Nitro
```

With `/gcreate` you fill in a short form (prize, duration, winners, optional image) and choose **Publish now** or **Customize in Studio**.

**4. Members enter**

Members press the **Enter** button on the giveaway message. If the giveaway uses reaction entry, they react instead.

**5. Winners are drawn**

When the timer ends the bot picks winners, updates the message and can DM them and open a winner thread. If someone never claims, use `/greroll`.

> [!TIP]
>
> Not sure about a command? Run `/help`, or `/help command:gstart` to see details for one command.

## Your first giveaway checklist

> **Before you start**
>
> * The bot can post in the channel.
> * You have **Manage Server**, **Administrator** or a Giveaway Manager role.
> * You know the prize, the duration (for example `1d`) and how many winners.

> **Make it safer**
>
> Add a required role, a minimum account age or the captcha so alt accounts and bots cannot win. See [Entry requirements](https://docs.giveawayx.lol/giveaways/entry-requirements.md).

> **Make it more exciting**
>
> Give boosters or supporters extra entries with [Bonus entries](https://docs.giveawayx.lol/giveaways/bonus-entries.md), or add an image from `/gcreate`.

> **After it ends**
>
> Winners can be DMed, get a role automatically and claim in a thread. Read [Winners and claims](https://docs.giveawayx.lol/giveaways/winners-and-claims.md).

> **[All giveaway options](https://docs.giveawayx.lol/giveaways/creating.md)**

> **[Ready-made recipes](https://docs.giveawayx.lol/giveaways/recipes.md)**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.