# Giveaway

The Giveaway Module can be accessed by first using the /assemble command and selecting the Utilities Branch. Once assembled, you will find the Giveaway Module among the available options, allowing you to manage and host giveaways efficiently within your Discord server.

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

To set up who can create giveaways using the Giveaway Module, you need to specify the allowed roles. This requires providing the Discord Role ID for each role you want to grant permission.

{% hint style="success" %}
To obtain a Role ID, right-click on the desired role within your Discord server. Note that you must have Developer Mode enabled in Discord to access Role IDs. To enable Developer Mode, go to User Settings > Advanced > Developer Mode, and toggle it on. Once enabled, right-clicking the role will display the option to copy its ID, which can then be used in the Giveaway Module configuration.
{% endhint %}

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

After configuring the allowed roles, you can create a giveaway by using the /giveaway create command. This command allows you to set various parameters to customize your giveaway, including:

* **Duration**: The length of time the giveaway will run.
* **Units of Time**: The units for the duration (e.g., seconds, minutes, hours, days).
* **Message**: The message that will be displayed for the giveaway.
* **tag\_role**: An optional role to mention in the giveaway message.
* **join\_roles**: Roles that participants must have to join the giveaway.

By specifying these parameters, you can tailor the giveaway to fit your server's needs.

<figure><img src="/files/1nc239TqRpONRDQ8YW0O" alt=""><figcaption></figcaption></figure>

After executing the /giveaway create command, a "Create a Giveaway" popup will appear. Within this interface, you can customize your giveaway by entering the following details:

* **Title**: The name or headline of the giveaway.
* **Description**: An optional message providing additional information about the giveaway.
* **Hex Color**: The hex color code that will define the visual theme of the giveaway message.
* **Number of Winners**: The total count of winners you wish to select at the end of the giveaway.
* **Prize**: A description of the prize being offered to the winners.

Filling out these fields allows you to set up your giveaway with clear and attractive details before launching it.

<figure><img src="/files/6tfpzAUi8oVA5DIjsAKp" alt=""><figcaption></figcaption></figure>

Once all the giveaway details are completed, the giveaway will be posted in the designated channel. Members can participate by clicking on the attached emoji, which acts as their entry into the giveaway. This interactive process makes it easy for members to join and for you to manage the giveaway efficiently.

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

{% hint style="info" %}
The /giveaway command offers additional functionalities to help you manage your giveaways effectively. These include:

* **/giveaway view-participants**: Allows you to see the list of members who have joined the giveaway.
* **/giveaway end**: Manually ends an active giveaway before its scheduled end time.
* **/giveaway reroll**: Selects new winners if you wish to rerun or redraw the giveaway.

These options provide greater control and flexibility in managing your giveaways within your Discord server.
{% endhint %}


---

# 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.guildabot.com/guilda-bot-knowledge-base/customer-guides/bot-usage/utilities-branch/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.