# Confetti

Fire a full-screen confetti burst on command, from your Deck or automatically on follows, subs and Bits.

**Confetti** is a full-screen effect. Nothing shows until you fire it; then paper, streamers, stars, hearts or sparks burst across your whole overlay and fade away. Use it for a reached goal, a raid, a win or simply because chat asked for it.

It lives with the other effects in the **Quick-Fire Deck**, not in the **Add** menu, and it never takes up a layer on your canvas.

## Fire it

::: steps
Open the **Quick-Fire Deck** in the editor toolbar (or press `kbd:Q`).

In the **Effects** section, click **Fire confetti**.

To change how it looks, click the gear button next to the effect. The settings card opens with all confetti options.
:::

In the settings card, **Fire test** shows a burst on the canvas so you can try settings without going live. Test and Fire buttons trigger the effect, so check which output is active before using them.

## Shape the burst

- **Mode** sets the shape of the fire: **Cannons**, **Fountain**, **Rain** or **Burst**.
- **Palette** picks the colors. **Custom colors** gives you three color pickers.
- **Shapes** chooses paper, streamers, stars, hearts, cubes, sparks or a mix.
- **Density**, **Intensity**, **Size**, **Duration (s)** and **Gravity** control how big and how long it is. Lower gravity floats longer.
- **Glow** adds a bright pass that works best with **Neon** or **Sparks**.

**Launch points** are where the confetti starts. Drag the launch markers on the stage to move them.

## Fire it automatically

Under **Triggers**, turn on **Fire on new follows**, **Fire on new/gift subs** or **Fire on cheers / bits**. Every matching event then sets off a burst, no button needed.

## Chat command

You and your mods can type `!confetti` in chat. It works on Twitch and Kick.

## Tips

- Add a **Sound** to play with every burst. Empty means silence.
- Put **Fire confetti** on a phone tile with the [Deck](/docs/deck) or on a key with the [Stream Deck](/docs/stream-deck).
- Pair it with a [Goal Bar](/docs/widgets/goal-bar) celebration or combine both in a Deck macro.

## Styles

Pick a style under **Palette** in the settings card: **Accent mix**, **Gold**, **Pastel**, **Neon**, **Custom colors**.

## Command reference

Every chat command this widget understands, with the default command names. Values in angle brackets are placeholders, for example a number.

| Command | What it does |
| --- | --- |
| `!confetti` | Fire confetti from the launch points |

## Settings

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

### Look

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Mode | Cannons | Cannons, Fountain, Rain, Burst | Shape of the fire. Launch points stay independent. |
| Custom color 1 | `#F4A6B8` | Any color |  |
| Custom color 2 | `#F5D76E` | Any color |  |
| Custom color 3 | `#8EE8FF` | Any color |  |
| Shapes | Paper | Paper, Streamers, Stars, Hearts, Cubes, Sparks, Mixed |  |
| Glow | Off | On or off | Additive glow pass. Best with Neon or Sparks. |
| Density | 1 | 0.25 to 2 |  |
| Intensity | Medium | Light, Medium, Heavy | Step size of a burst. Density still fine-tunes the count. |
| Size | 1 | 0.6 to 1.8 |  |
| Duration (s) | 2.5 | 1 to 6 |  |
| Gravity | 100 | 25 to 200 | 100 is the snappy default - lower values float longer. |
| Motion trails | On | On or off | Off removes flight trails. Particles still move. |

### Launch points

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Launch points | 2 points | Up to 8 markers on the canvas | Drag the launch markers on the stage. |

### Triggers

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Fire on new follows | Off | On or off |  |
| Fire on new/gift subs | Off | On or off |  |
| Fire on cheers / bits | Off | On or off |  |

### Sound

| Setting | Default | Values | Notes |
| --- | --- | --- | --- |
| Sound | Empty | Text | Plays when confetti fires. Empty is silence. |
| Sound volume | 70 | 0 to 100 | Upload or paste a sound first. |