Skip to main content

Creating Triggers

This guide walks you through creating and configuring a stream trigger.

Step 1: Open Stream Triggers

Navigate to Stream Triggers in the sidebar under the Streaming section.

Step 2: Create a New Trigger

  1. Click the Create Trigger button
  2. Select the event type you want to respond to (Follow, Subscription, Cheer, Gifted Subs, or Raid)
  3. Give your trigger a descriptive name

Step 3: Add Trigger Rules

Each trigger can have multiple rules with different conditions. For example, a cheer trigger might have:

  • A rule for cheers of 1–99 bits with a basic alert
  • A rule for cheers of 100+ bits with a premium alert and TTS

To add a rule:

  1. Click Add Rule on your trigger
  2. Configure the conditions specific to the event type:
    • Cheer — Set a minimum bit amount
    • Subscription — Set a minimum tier (Tier 1, 2, or 3) and/or minimum months
    • Gifted Subs — Set a minimum tier and/or minimum gift count
    • Raid — Set a minimum viewer count
    • Follow — No additional conditions (fires on any follow)

Step 4: Assign Assets

For each rule, select the images and audio to use:

  1. Click on the rule to expand its settings
  2. Images — Select one or more images from your library to display
  3. Audio — Select one or more audio clips to play

If multiple assets are assigned, one is chosen randomly each time the trigger fires.

Step 5: Set Priority

If you have multiple rules that could match the same event, set their priority to control which one fires:

  • Higher priority rules are checked first
  • The first matching rule wins

Step 6: Configure Global Settings

The trigger's global settings apply to all rules:

SettingDescription
Custom AssetsAllow viewers to submit their own images/audio
Custom Permission Modenone, requires_approval, streamer_only, or all
Allow MatureWhether mature-flagged assets can be used
Max Text LengthCharacter limit for viewer messages
ModerationEnable content filtering with custom banned/allowed terms

Tips

  • Start with one rule per trigger and add complexity as you learn
  • Test your triggers using the test button before going live
  • Check your overlay — Triggers need an Alert Box widget in your overlay to display
  • Use priority to create tiered alert experiences (e.g., bigger cheers get fancier alerts)

See Also