Tokens are {placeholders} you drop into alert text, label templates and goal labels. They fill in with live values when the widget renders. This is the full set, grouped by where you use them.
Subscriber alert
Token
Value
{name}
The subscriber.
{tier}
Tier 1, 2, 3 or Prime.
{months}
Months in this sub.
{cumulative_months}
Total months subscribed.
{streak_months}
Current consecutive months.
{gift_count}
Number of gifts in a gift batch.
{sender}
The gifter, on gifted subs.
{message}
The resub message.
Cheer, tip, raid, follow
Token
Value
{name}
The viewer (cheerer, tipper, raider or follower).
{bits}
Bits cheered.
{amount}
Tip amount, or raid viewer count, depending on the alert.
{currency}
Tip currency.
{viewers}
Raid viewer count.
{message}
Cheer or tip message.
Channel points & shoutout
Token
Value
{name}
The redeemer, or the channel you shouted out.
{reward_title}
The reward redeemed.
{reward_cost}
The point cost.
{user_input}
The message attached to a redemption.
Merch alert
Token
Value
{product}
First item in the order.
{random_product}
A random item from the order.
{product_list}
All items, comma separated.
{item_count}
Number of items.
{total_display}
Order total with currency symbol.
{first_product_image}
Image of the first product.
{matched_category}
The collection the order matched.
Goals
Token
Value
{current}
Current progress.
{target}
The goal target.
{progress_pct}
Progress as a percentage.
{remaining_to_target}
How much is left.
{metric_label}
The metric name.
{period_label}
The period, like This stream.
Countdown & subathon
Token
Value
{remaining}
Time left, formatted.
{elapsed}
Time elapsed, formatted.
{added_total}
Total time added from events (subathon).
{last_event_user}
Who last added time (subathon).
Latest events
The most recent person or value for each event type. Great for a "latest follower / sub / tip" strip. These update live as events come in.
Token
Value
{latest_follower}
Most recent follower (with @).
{latest_follower_name}
Most recent follower (no @).
{latest_sub_name}
Most recent subscriber.
{latest_sub_tier}
Their tier (1, 2, 3 or Prime).
{latest_sub_months}
Their months subscribed.
{latest_sub_gifter}
Who gifted the most recent gift sub.
{latest_sub_gift_count}
Gifts in the most recent gift batch.
{latest_tipper}
Most recent tipper.
{latest_tip_amount}
Their tip amount.
{latest_tip_message}
Their tip message.
{latest_cheer_name}
Most recent cheerer.
{latest_cheer_amount}
Their bits.
{latest_cheer_message}
Their cheer message.
{latest_raider}
Most recent raider.
{latest_raid_viewers}
Their raid viewer count.
{latest_redemption_name}
Most recent channel-point redeemer.
{latest_redemption_reward}
The reward they redeemed.
{latest_redemption_cost}
Its point cost.
This session
Counts for the current stream. They reset a few minutes after you go offline.
Token
Value
{session_followers}
Followers this session.
{session_subs}
Subs this session.
Session leaderboards
The top tip, tipper, cheer and cheerer this session, split so you can place the name and the amount separately.
Token
Value
{session_top_tip_name}
Biggest single tip: who.
{session_top_tip_amount}
Biggest single tip: amount.
{session_top_tipper_name}
Biggest tipper overall: who.
{session_top_tipper_amount}
Biggest tipper overall: total.
{session_top_cheer_name}
Biggest single cheer: who.
{session_top_cheer_bits}
Biggest single cheer: bits.
{session_top_cheerer_name}
Biggest cheerer overall: who.
{session_top_cheerer_bits}
Biggest cheerer overall: total bits.
Session chat
Token
Value
{session_top_chatter_name}
Most active chatter this session (bots excluded).
{session_top_chatter_count}
Their message count.
{session_chat_messages}
Total chat messages this session.
Channel totals and trends
Token
Value
{current_subs}
Current active subscribers.
{total_subs}
Current subscribers (alias of current_subs).
{total_followers}
Lifetime follower count.
{total_cheers}
All-time bits cheered.
{total_tips}
All-time tip total.
{7d_followers}
Followers in the last 7 days.
{30d_followers}
Followers in the last 30 days.
{7d_subs}
Subs in the last 7 days.
{30d_subs}
Subs in the last 30 days.
Hype train
Live while a Hype Train is running, then the final values linger for your "latest hype train" readout. See Hype Train for the full feature.
Token
Value
{hype_train_active}
yes while a train is running, otherwise no.
{hype_train_level}
Current (or final) level.
{hype_train_progress}
Points toward the next level (empty at the end).
{hype_train_goal}
Points needed for the next level (empty at the end).