Using Event Data in Actions
7 minute readUpdated 15 November 2026
When an alert fires, TipLink has information about the event that triggered it, like the viewer's name, the donation amount, or the message they included. You can insert this information directly into your action text using a simple {{ }} syntax.
No coding needed. Just curly braces around a field name.
The Easy Way: The Placeholder Picker
You do not have to remember any field names.
Click the {{ }} button next to any text field in an action. This opens the Placeholder Picker, a searchable list of everything available for that alert. Click an entry and it is inserted at your cursor.
The picker groups entries by where they come from:
| Group | What it holds |
|---|---|
| Platform → Event | Fields from the event that triggers this alert, such as the viewer's name and the tip amount. Only the platforms and events you selected are shown. |
| Viewer | The viewer's tracked points balance. |
| Rate Limits | How long is left on a cooldown. |
| Global Variables | Every variable you have created. |
| Other actions | Results produced by earlier actions on the same alert, such as the final PiShock intensity. |
The picker does not currently cover DonationAlerts, Points Redemptions, OBS Studio, VRChat, Custom OSC, TipLink Countdowns or Webhooks. Their placeholders still work, you just have to type them in.
To find the field names, fire the event once and open it on the Activity page. Anything under metadata can be used as {{ fieldName }}.
The rest of this page explains the syntax, for when you would rather type it yourself.
How It Works
Anywhere you can type text in an action (overlay message, Discord message, chat message, etc.), you can use a placeholder to insert live event data.
Basic format:
{{ fieldName }}
Example - Overlay message:
{{ username }} just donated {{ value }}!
If username is "CoolViewer42" and value is 10, TipLink sends:
CoolViewer42 just donated 10!
Common Event Fields
These fields are available in most events. Exact availability depends on the platform and event type.
| Field | What it contains | Example output |
|---|---|---|
{{ username }} | The viewer's username or display name | CoolViewer42 |
{{ value }} | The numeric value of the event (donation amount, sub count, bits) | 10 |
{{ message }} | The message the viewer included | Keep it up! |
{{ currency }} | The currency of a donation | USD |
{{ type }} | The event type | donation |
{{ platform }} | The platform the event came from | twitch |
Open the Activity page, find an event, and click the magnifying glass icon to view its full details. All fields listed under metadata can be used in the format {{ fieldName }}.
For example, if you see metadata.id, you can access it with {{ id }}.
Always-Available Placeholders
These work on every alert, whatever platform triggered it.