> For the complete documentation index, see [llms.txt](https://docs.engages.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.engages.io/engage-discord/reward-hub/giveaways.md).

# Giveaways

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

You can launch a raffle in seconds with the **`/raffle`** command.

* **`giveaway_title`** – Name of the raffle.
* **`winners`** – Number of winners (1 – 999).
* **`ticket_cost`** – Cost of a single ticket in points (0 – 10,000). Set `0` for a free raffle.
* **`duration`** – How long the raffle stays open.
* **`chain`** – Chain of the reward (ETH / BTC / SOL / SUI / AVAX / ZKS / BSC / SEI / ADA / RONIN / No Chain).

**Extra options**

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

* **`description`** – Description shown on the raffle embed.
* **`twitter`** – Twitter link of the project (used for the banner).
* **`role_reward`** – Role to assign to every winner.
* **`role_gate`** – Only members with the chosen role can join the raffle.
* **`image`** – Custom image for the raffle embed.
* **`manual_notify`** – Ping a specific role instead of the default notify role.
* **`max_cost`** – When set, members spend up to this many points combined across all their tickets. (`ticket_cost` must be `0` when using `max_cost`.)
* **`limited_entry`** – Limit the raffle to one ticket per user.
* **`note`** – Custom note appended to the raffle embed.

**Example raffle**

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