# Giveaway

Show your PXStudioBot giveaway on stream, from the entrant wall to the countdown and the winner reveal.

The **Giveaway** widget puts your giveaway on stream. While entries are open, viewers see who joined and how much time is left; when you draw, the winner gets their big moment. The giveaway itself runs through [PXStudioBot](/docs/pixbot): the widget only shows what the bot is doing, so it always matches your chat.

::: widget pixbot-giveaway standard 300

## Add it

::: steps
Click **Add** in the toolbar (or press `kbd:W`) and pick **Giveaway** under **Games & Interactive**.

Set a **Title** and, if you like, a default **Prize**.

Choose what it should **Show**: **Entrant wall**, **Ticker line**, **Countdown** or **Winner only**.

Pick a look with **Choose a look** and drag it into place.
:::

## Run a giveaway

::: steps
Open **Giveaway** in the editor toolbar (`kbd:Y`).

Enter the **Prize** and the **Keyword**. By default viewers enter with `!join`. Under **More options** you set the duration, the number of **Winners**, a **Claim timeout** and **Who can enter**.

Click **Start giveaway**. The widget shows entries as they come in.

Click **Draw** when you are ready. The winner appears on stream and confirms with `!claim` in chat.
:::

**Entry trigger** can be a **Command** (`!join`), a plain **Word** anywhere in chat, **Any** of both, or a Twitch **Channel Points** reward. **Luck** gives subs, VIPs or mods extra tickets.

## Control it live

Select the widget and the giveaway controls appear above it: **Start giveaway**, **Draw winner**, **Reroll winner** and, under **More**, **Pause entries**, **Resume entries**, **Close entries**, **Next winner** and **Cancel giveaway**. The same controls are on your phone [Deck](/docs/deck) and on a [Stream Deck](/docs/stream-deck), so a mod can run the giveaway for you.

> [!NOTE]
> The round's own prize, set when you start it, wins over the **Prize** text in the widget settings.

## Display options

- **Winner only** stays invisible until a winner is drawn. Good for a clean layout.
- **Show entry count**, **Show timer** and **Show avatars** turn parts of the card on or off.
- **Show winner for (s)** sets how long the winner card stays before it fades.
- **Compact** makes a denser card with smaller entrant chips.

## Tips

- Turn on **Show disclaimer** to show that the promotion is yours and not sponsored by Twitch. You can edit the text.
- **Followers only** and **Exclude past winners** under **Who can enter** keep giveaways fair.
- More on points, rewards and giveaways: [Loyalty and giveaways](/docs/loyalty-and-giveaways).

## Looks

Pick a look under **Look** in the settings card. Every look is a complete style; colors and fonts you set yourself stay on top. 15 looks are available:

::: looks pixbot-giveaway
standard Standard
miami Miami
lootdrop Loot Drop
comic-pop Comic Pop
cinematic Cinematic
esports Esports
terminal Terminal
blocky Blocky
lofi Lofi
neon-pulse Neon Pulse
midnight Midnight
pastel-pop Pastel Pop
retro-arcade Retro Arcade
gilded Gilded
minimalism-dark Minimalism Dark
:::

## Settings

All settings live in the floating settings card on the right of the editor. Defaults are what a new widget starts with.

### Text

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Title | Giveaway | Text |  |
| Prize | Empty | Text | Shown under the title. The round's own prize (set when you start it) wins over this text. |
| Show disclaimer | Off | On or off |  |
| Disclaimer | This is a promotion by the streamer. Twitch does not sponsor or endorse it. | Text |  |

### Layout

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Show | Entrant wall | Entrant wall, Ticker line, Countdown, Winner only | Winner only stays invisible until a winner is drawn. |
| Width (px) | 380 | 240 to 720 |  |
| Compact | Off | On or off | A denser card: smaller entrant chips, tighter spacing, a smaller prize and winner name. Every look keeps its own style. |
| Show entry count | On | On or off |  |
| Show timer | On | On or off |  |
| Show avatars | On | On or off |  |

### Design

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Accent color | Look default | Any color |  |
| Winner moment | Full | Full, Subtle |  |
| Show winner for (s) | 8 | 3 to 60 | How long the winner card stays after the round ends before the overlay fades. |