Triggers

Created 25 Nov 2025·Updated 31 Jul 2026

A trigger is what decides whether an alert fires. When an event arrives, TipLink checks each alert's trigger to find a match.

---

The Four Parts of a Trigger

Every alert answers four questions:

1. Which platforms? For example only Twitch, or Fansly and Ko-fi together.
2. Which accounts? If you have two Twitch channels connected, pick the one this alert watches.
3. Which events? For example Tip, New Follower, or Chat Message.
4. Which conditions? Optional extras such as a minimum tip amount or a chat command.

All four must match for the alert to fire.

---

Where Triggers Come From

Triggers do not have to come from a streaming platform. TipLink can also trigger alerts from its own features.

Platform accounts

Anything you have connected on the Platforms page can trigger an alert. Each platform offers its own list of events.

Group	Platforms
Streaming Platforms	Twitch (Your Channel), Twitch (Other Channels), Fansly, Joystick.TV, Kick, TikTok Live, YouTube Live, Chaturbate, Stripchat
Tips & Donations	StreamElements, Streamlabs, DonationAlerts, Ko-fi, BuyMeACoffee, Throne
Streaming Tools	OBS Studio
Music	Spotify, Winamp
Games & VR	VRChat
Advanced	Webhook, Custom OSC

Each platform's setup guide lists the events it can send. See Connect Your Platforms.

TipLink's own triggers

These need no account and are always available.

Trigger source	Event	Fires when
TipLink Goals	Goal Completed	A goal reaches its target. See Goals.
TipLink Goals	Goal Milestone Reached	A goal passes a progress percentage you choose.
TipLink Countdowns	Countdown Completed	A countdown timer reaches zero. See Variables.
TipLink Variables	Variable Value Changed	A variable's value changes.
Points Redemptions	Viewer Redeemed Points	A viewer spends their points on one of your redemptions.

Manual Trigger Only

Instead of choosing a platform, you can set an alert to Manual Trigger Only. It never fires on its own. It only runs when another alert calls it with the Trigger Alert action.

This is how you build a shared set of actions once and reuse it from several alerts.

---

Conditions

Conditions narrow down when an alert fires. Which ones appear depends on the event type you chose.

Amount conditions

For anything with a number attached, such as a tip, gifted subs or bits, you can set a range.

Setting	What it does
Minimum	The lowest value that will fire the alert.
Only Use Minimum (no maximum)	Turn on for "this amount or higher, with no upper limit".
Maximum	The highest value that will fire the alert. Only shown when the toggle above is off.

"$5 to $20 tips": Minimum 5, Maximum 20, no-maximum toggle off.

"Any tip of $10 or more": Minimum 10, no-maximum toggle on.

What counts as the value

For tips it is the amount. For subs it is the number of months. For gifted subs it is how many were gifted. For bits it is how many were cheered.

Chat message conditions

Setting	What it does
Chat Message Match	The text to look for. Leave empty to match every message.
Ignore Case	Treat !Shock and !shock as the same. On by default.
Match Contains	Fire if the message contains your text anywhere, rather than being exactly that text. Useful for catching !shock please.
Do you want to match using Regex?	For advanced users. Match with a regular expression instead of plain text. Hides the two options above.

Who is allowed to trigger it

Chat message conditions can be limited to certain viewers.

Setting	What it does
Only Subscribers	Only subscribers can trigger it. You can also limit this to specific tiers.
Only VIPs	Only VIPs can trigger it.
Only Moderators	Only moderators can trigger it.
Only Founders	Only founders can trigger it.
Only Broadcaster	Only you can trigger it.

When you turn on more than one of these, a Role Match Mode option appears:

Mode	What it means
Require ALL selected roles	The viewer must have every role you ticked, for example VIP and subscriber.
Require AT LEAST ONE selected role	The viewer needs any one of them, for example VIP or subscriber.

The broadcaster always passes

You can always trigger your own alerts, whatever the role settings say. This means you can test a subscriber-only command yourself.

Username lists

Setting	What it does
Enable Username Whitelist	Only the usernames you list can trigger the alert.
Enable Username Blacklist	The usernames you list can never trigger the alert.

Enter usernames separated by commas, for example user1, user2, user3. Capitalisation does not matter.

---

Alert Order

Alerts are checked top to bottom on the Alerts page, and the first match wins.

This means:

• Put more specific alerts, such as "$100 or more", above general ones.
• Put a catch-all alert, such as minimum 0.01 with no maximum, last.

Drag the handle (⠿) on the left of an alert to move it.

Making a second alert fire too

If you want another alert to run as well as the winning one, turn on Always Trigger in that alert. See Alerts for how multiple alerts run together.

---

Alert Sets Can Block a Trigger

If an alert belongs to one or more Alert Sets, at least one of those sets must be enabled or the alert will never fire, no matter how well the trigger matches.

---

Testing a Trigger

You do not have to wait for a real event.

• Test Actions from the alert's ⋮ menu fires the actions straight away, skipping the trigger entirely. Good for checking an action is set up right.
• The Event Testing Tool lets you build a fake event and run Check Conditions, which shows you exactly which part of the trigger passed or failed.
• Replay on the Activity page runs a real past event through your alerts again.

---

Tips

• One alert can watch several event types at once. For example, one alert could fire for both tips and gifted subs.
• If you want different behaviour at different amounts, make separate alerts with different ranges and order them from highest to lowest.
• If an alert is not firing, work down this list: is the account connected, is the event type excluded on that account, is the alert enabled, is its alert set enabled, does another alert above it match first.