Skip to main content

Alerts & Stream Triggers

Stream triggers are rules that fire when events happen on your Twitch channel. When a trigger fires, it activates an alert — a visual and audio notification displayed on your overlay.

How It Works

The alert pipeline has three parts:

  1. Event — Something happens on your channel (a follow, sub, cheer, raid, etc.)
  2. Trigger — Streamerly checks your trigger rules to decide how to respond
  3. Alert — The matched trigger activates an alert on your overlay's Alert Box widget

Each trigger defines which event type it responds to, what conditions must be met (minimum bits, sub tier, etc.), and which assets (images and audio) to use.

Event Types

EventDescription
FollowA viewer follows your channel
SubscriptionA viewer subscribes (new or recurring, tier 1/2/3)
Gifted SubsA viewer gifts subscriptions to others
CheerA viewer cheers with bits
RaidAnother streamer raids your channel

Key Concepts

  • Trigger Rules — Each trigger can have multiple rules with different conditions (e.g., one rule for cheers under 100 bits, another for cheers over 1000)
  • Priority — When multiple rules match, priority determines which one fires
  • Assets — Each rule specifies which images and audio clips to use
  • Super Cheers — A special system where viewers can submit custom images and audio with their cheers
  • Moderation — Content moderation filters for user-submitted custom alerts

Getting Started