Choose a trigger

Which trigger to pick for gifts, likes, chat commands, subs, rewards, raids, milestones, games and your own apps.

The trigger is what an event waits for. Pick it from Event Type at the top of the event editor, and the fields under it change to ask what that trigger needs.

Find the right trigger

The list starts with what happens on stream, then the triggers matched by text you type: API trigger and Chat message.

To react to…	Choose
A gift, or any gift worth enough	Gift
Likes, follows or shares	Like, Follow, Share
A word or a command in chat	Chat message
Someone saying hello for the first time	First chat this stream
A new subscriber or member, a raid, a hype train	Subscription, Raid, Hype train
A Twitch channel point reward	Twitch channel points
Going live, or ending the stream	Stream starts, Stream ends
Something on a clock	Every few minutes
A goal, the timer, a wheel or a game	Overlay goal reached, Timer reaches zero, Wheel result, Giveaway winner, Tug of war win, Hype level reached
A message from your own tool	API trigger

Raid, Hype train and Twitch channel points Twitch only appear in the list once Twitch has connected.

Type a name in Gift Name, or click Catalog to pick one with its picture. Under Match, choose Exactly this gift so a Rose event ignores a Rose Bouquet, or Name contains to catch both.

Leave the name empty to react to any gift. Then set Worth at least to react only to bigger ones, such as any gift worth 100 diamonds or more.

Advanced Settings holds the rest:

At most (◆) caps the value, so a small-gift event and a big-gift event never both fire.
Value of measures The whole combo (gift × count) or One gift.
Quantity Behavior runs the steps once per combo, repeats them for every gift in it, or stretches their duration.
Count from all viewers adds everyone's gifts together. Set Count to Diamonds for "every 1,000 diamonds from everyone".

Twitch, Kick and YouTube support arrives as gifts too: bits as Cheer, Kick's Kicks, YouTube's Super Chat and Super Sticker, and gifted subs and gifted memberships as Gift Sub. Set what each is worth in SettingsPointsWhat events are worth, and one gift event covers every platform.

TikTok LIVE, Twitch, Kick and YouTube feed the same events, so one trigger covers all four.

React to YouTube

YouTube needs no triggers of its own. Each kind of activity reaches one you already use:

On YouTube	Sets off
A chat message	Chat message, and First chat this stream for a viewer's first
A Super Chat or a Super Sticker	Gift, named Super Chat or Super Sticker, worth its value in diamonds
A Jewels gift	Gift, under the gift's own name, worth no diamonds
Gifted memberships	Gift, named Gift Sub, for the viewer who bought them
A new member, or a membership milestone	Subscription, with the months in `{months}`

A Super Chat's message also arrives as chat, after the gift, the way a Twitch cheer's does, so chat commands and text to speech read it like any other message. Each viewer who receives a gifted membership also sets off Subscription.

Channel badges work with Who can trigger this: a member counts as a subscriber, and a moderator as a moderator. Once YouTube has connected, the Dashboard's Event Simulator has a Super Chat button for trying these events without going live.

React to Twitch channel points

Choose Twitch channel points, then pick a reward from the menu under it. It lists your channel's custom rewards with their point costs. Choose Any reward to react to every redemption, and click Refresh rewards after you add one on Twitch.

The event remembers the reward by its ID, so renaming the reward on Twitch does not break it. If Twitch reports the same redemption twice, the event runs once. Its steps get {rewardName}, {rewardCost} and, for a reward that asks the viewer for text, {comment}.

A reward suits a sound. Add a Play sound step and choose where it plays. For OBS, copy the OBS audio source URL shown under the reward menu into an OBS Browser Source.

The rewards load only while Twitch is connected and signed in as the channel's broadcaster. If the menu asks you to, sign in to Twitch again and allow channel point redemption access.

React to likes, follows and shares

Like, Follow and Share fire for each viewer who does it. For likes, set Minimum likes under Advanced Settings. Turn on Count from all viewers and likes from everyone add up until they reach that number.

For a celebration at a round number, use Room like milestone, Viewer count milestone or Follower count milestone. Set the Threshold, and tick Repeat at every multiple to fire again at 2,000, 3,000 and so on.

React to chat

Choose Chat message and type the word or command in Trigger Text. The menu beside it sets how it matches:

Mode	Matches
Contains	Any message with the text in it.
Exact	The whole message and nothing else.
Starts with	Messages that begin with the text.
Command and arguments	A command followed by words, like `!spin 90`. The words arrive as `{arg1}`, `{arg2}` and `{args}`.
Restricted regular expression	A pattern, for advanced matching.

The Aa switch makes matching case-sensitive. A chat command can also cost points; see Rules and cooldowns.

React to stream moments

Stream starts and Stream ends suit a welcome scene and an outro. Every few minutes runs on a clock for reminders; see Repeating timers.

TikTok LIVE has triggers of its own: Viewer joins, Super Fan, Subscriber emote, Treasure box, LIVE question, TikTok LIVE goal and Battle. A battle event picks its Battle phase and, optionally, its Battle outcome.

React to goals and games

Overlay goal reached, Timer reaches zero, Wheel result, Giveaway winner, Tug of war win and Hype level reached fire when a widget on your overlay gets there. Leave Widget ID or result key (empty matches all) empty to react to all of them, or fill it in to react to one: a wheel prize, a team name, or a hype level.

Each passes its result to your steps, such as {winner} for the giveaway or {team} for tug of war. See Games.