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

# Twitch Giveaways

> Run Twitch giveaways with luck multipliers for subscribers. Easy winner selection and chat announcements.

## How to Use Giveaways

Vision Giveaways let you run contests where viewers can participate through chat. Set up entry requirements, configure luck multipliers for different user types, and randomly select winners - all from your dashboard.

### Getting Started

<Steps>
  <Step title="Go to Giveaways">
    In the Vision dashboard, click **Giveaways** in the sidebar
  </Step>

  <Step title="Start a Giveaway">
    Click **Start Giveaway** to open the setup dialog
  </Step>

  <Step title="Configure entry method">
    Choose how viewers enter (keyword or active users)
  </Step>

  <Step title="Set up prize">
    Add prize details - name, image, and link
  </Step>

  <Step title="Adjust settings">
    Configure luck multipliers and participant limits
  </Step>

  <Step title="Launch">
    Start the giveaway and announce it to your chat
  </Step>
</Steps>

***

## Entry Types

### Keyword Entry

Viewers type a specific word in chat to enter:

* Set a keyword (e.g., "!giveaway", "enter", "!win")
* Only viewers who type the keyword participate
* Prevents accidental entries

### Active Users

Automatically includes active chatters:

* Anyone chatting is eligible
* Set an inactivity timeout (e.g., viewers silent for 5 minutes are removed)
* Great for rewarding engaged viewers

***

## Luck Multipliers

Give certain viewer types better odds of winning:

| User Type      | Description         | Example Multiplier |
| -------------- | ------------------- | ------------------ |
| **Viewer**     | Regular viewers     | 1x                 |
| **Subscriber** | Channel subscribers | 2x                 |
| **VIP**        | VIP badge holders   | 1.5x               |
| **Moderator**  | Channel moderators  | 1x                 |

A subscriber with 2x multiplier has double the chance of winning compared to a regular viewer.

<Steps>
  <Step title="Open settings">
    In the giveaway setup, find the luck multiplier section
  </Step>

  <Step title="Set multipliers">
    Adjust the multiplier for each user type
  </Step>

  <Step title="Enable user types">
    Toggle which user types can participate
  </Step>
</Steps>

***

## Giveaway Settings

| Setting                | Description                                               |
| ---------------------- | --------------------------------------------------------- |
| **Max Participants**   | Limit how many can enter (optional)                       |
| **Inactivity Timeout** | Remove inactive users after X seconds (active users mode) |
| **Chat Announcements** | Post winner to chat automatically                         |
| **Unique Winners**     | Prevent same person winning multiple times                |
| **Remove Spammers**    | Filter out spam entries                                   |

***

## Selecting Winners

<Steps>
  <Step title="Click Pick Winner">
    When ready, click the **Pick Winner** button
  </Step>

  <Step title="Winner is selected">
    A random winner is chosen based on luck multipliers
  </Step>

  <Step title="Announce">
    The winner is shown and optionally announced in chat
  </Step>

  <Step title="Pick more winners">
    Select additional winners if giving away multiple prizes
  </Step>
</Steps>

***

## Multi-Channel Giveaways

Run giveaways across multiple Twitch channels:

1. In giveaway setup, click **Channels**
2. Select additional channels to include
3. Viewers from all selected channels can participate
4. Great for collaborations and raids

***

## Chat Announcements

Enable automatic chat announcements:

* **Winner announcement** - Posts winner username to chat
* **Customizable message** - Format the announcement as needed

***

## Letting Your Mods Help

1. Go to **Permissions → Roles**
2. Create or select a role with giveaway permissions
3. Invite your moderators
4. They can start giveaways and pick winners

***

## Tips

<Tip>
  **Set a clear keyword** that's easy to type but unlikely to be said accidentally (e.g., "!giveaway" instead of "yes").
</Tip>

<Tip>
  **Use unique winners** when giving away multiple prizes to spread the love across your community.
</Tip>

<Tip>
  **Reward loyalty** by setting higher multipliers for subscribers - it encourages subscriptions while keeping the giveaway fair.
</Tip>

<Tip>
  **Save your settings** - Vision remembers your giveaway configuration for quick reruns.
</Tip>
