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

# Giveaways

> Host interactive giveaways in any channel you choose.

Giveaways are a fun and effective way to engage your community and distribute rewards. You can set up fully customizable giveaways in any channel, choose how long they last, and let members join or leave with ease.

<Frame>
  <img src="https://mintcdn.com/miona/T-Ii_MvXcsOpaOcQ/images/giveaways/example-giveaway.png?fit=max&auto=format&n=T-Ii_MvXcsOpaOcQ&q=85&s=847f07be8ff3a33cacdeba5d26e34529" alt="Example giveaway" width="566" height="285" data-path="images/giveaways/example-giveaway.png" />
</Frame>

## 🎉 How to Start a Giveaway

To begin a giveaway, simply run:

```sh theme={null}
/giveaway start
```

After running the command, a form will appear where you can fill in the giveaway details such as:

* Prize
* Duration
* Number of winners
* Description

Click **Submit** to launch the giveaway!

<Frame>
  <img src="https://mintcdn.com/miona/T-Ii_MvXcsOpaOcQ/images/giveaways/example-form.png?fit=max&auto=format&n=T-Ii_MvXcsOpaOcQ&q=85&s=34597c1c9b585781fc992c476492fdd5" alt="Giveaway form example" width="720" height="622" data-path="images/giveaways/example-form.png" />
</Frame>

A giveaway embed will be posted in the current channel, along with a join button for members.

## ⚙️ Editing Giveaway Settings

To customize the appearance and behavior of giveaways, use:

```sh theme={null}
/giveaway settings
```

You’ll be able to modify:

* Embed color
* Join button emoji
* Button label

<Frame>
  <img src="https://mintcdn.com/miona/T-Ii_MvXcsOpaOcQ/images/giveaways/example-settings.png?fit=max&auto=format&n=T-Ii_MvXcsOpaOcQ&q=85&s=58644c2f2e7443bdd69fc09ec0892bf4" alt="Giveaway settings" width="479" height="474" data-path="images/giveaways/example-settings.png" />
</Frame>

## 🔁 Rerolling a Winner

Need to pick a new winner? After a giveaway ends, run:

```sh theme={null}
/giveaway reroll <giveaway_id> [winners_count]
```

## ⏹️ Ending a Giveaway Early

To forcibly end an ongoing giveaway and pick a winner immediately, use:

```sh theme={null}
/giveaway end <giveaway_id>
```

## 👥 Viewing Giveaway Participants

To view all participants (entries) in a giveaway, use:

```sh theme={null}
/giveaway entries <giveaway_id>
```

## 🗑️ Deleting a Giveaway

If you want to cancel a giveaway without drawing a winner, use:

```sh theme={null}
/giveaway delete <giveaway_id>
```

The giveaway will be removed immediately.

## 📋 Viewing Active Giveaways

To see a list of all currently active giveaways, run:

```sh theme={null}
/giveaway list
```

<Frame>
  <img src="https://mintcdn.com/miona/T-Ii_MvXcsOpaOcQ/images/giveaways/example-list.png?fit=max&auto=format&n=T-Ii_MvXcsOpaOcQ&q=85&s=69f1ecb6b4a6b42720a6fb8342a28eb4" alt="Active giveaways list" width="712" height="295" data-path="images/giveaways/example-list.png" />
</Frame>
