# Create a Giveaway

**1.** To start a giveaway, type /**giveaway start \[time] \[winners] \[title] \[role] \[channel] \[image]**\
**Example: /giveaway start 1h 2 Discord Nitro! @level 20 #giveaways** would start 1 hour giveaway for Discord Nitro with 2 winners in channel #giveaway. It would also require all members to have the @level 20 role in order to win.

{% hint style="info" %}
If you set the required role, the bot will filter out all members who don't have that role. The giveaway may end with no valid entrants due to no one meeting the criteria.
{% endhint %}

You may use the following duration formations: **"m", "h", "d", "w", or "month"**\
\&#xNAN;**`60s`,`1m`,`1 minute`** **`24h`,`1d`,`1 day`** **`7d`,`1w`,`1 week`** **`30d`,`4w`,`1 month`**

**2.** To re-roll a giveaway, type `/giveaway reroll [message id]`\
**Example: /giveaway reroll 980656234539663584**

**3.** To end a giveaway, type `/giveaway end [message id]`\
**Example: /giveaway end 980656234539663584**

**4.** For a list of current giveaways, type `/giveaway list`

{% hint style="info" %}
By default, you need the **Manage Server** permissions to create and manage giveaways. If you want another role or member to have access, go to **Server Settings > Integrations > Bots and Apps > Sx Bot.**
{% endhint %}

<figure><img src="/files/2YB653W6j1wEezNwIRk7" alt="" width="369"><figcaption><p>Discord giveaway example</p></figcaption></figure>

You can also use the built-in help guide the bot offers by using **`/giveaway help`** as seen below.

<figure><img src="/files/rWKOFkfHxBpwkMOrMOHm" alt=""><figcaption></figcaption></figure>


---

# 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.sxbot.io/giveaways/create-a-giveaway.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.