OverlayThing Docs
Home
Login / Request Access
01 Get started
Introduction Quickstart Add to your stream
02 Overlays
Overlays The editor Overlay URLs Alert queue Share, export & import
02.1 Widgets
Widgets overview Alerts Variations Hype Train Text to speech Goals Countdown & subathon Chat box Data labels Counter Text, image & video
03 Chatbot
Chatbot overview Getting started Commands Variables Conditionals Recipes API commands Integrations Command API & Copy-URL Chat moderation Bot account Bot settings
03.1 Chatbot modules
Modules overview Timers Counters Quotes Chat alerts Welcome Ad Breaks Giveaways Queue Song requests Loyalty
04 Flows
Overview Build a flow Triggers Conditions Actions Using data Examples
05 Channel Rewards
Channel Rewards
06 Remote Control
Overview Connect OBS Studio Connect Meld Studio Bindings & triggers Security & access
07 OBS Dock
Overview & setup Layouts & display Chat & Needs You Activity & media Stream info & controls
08 Companion
Companion overview Install & pair Feed, chat & channel Scripting The scripting API Permissions & security
09 Monetize
Tip page Tip settings Merch with Fourthwall
10 Build your own
Describe & Build Custom widgets Widget SDK
11 Your data
Dashboard Stream data Chat log Moderation
12 Account
Settings & connections Export your data Import from StreamElements
13 Reference
Label tokens Keyboard shortcuts FAQ Troubleshooting
Reference/Label tokens
Reference

Label tokens.

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.

How tokens work

Write a token anywhere in an alert or a text block and it is replaced when the widget renders. Insert one from the Tokens rail in the designer, or type { inside a text block to open the picker.

Alert tokens describe the event that fired the alert, so they only mean something on that alert. Data label tokens describe your channel and are live on any overlay, all the time.

Today, this week and this month are read in the time zone you set in Bot settings. The week runs Monday to Sunday. The 7 day and 30 day tokens are rolling: always the last 7 or 30 days counting back from now, never a calendar week or month.

Your Stream Data page, the Leaderboard widget and the chat and mod logs still count their days in UTC, so a Leaderboard "today" beside a {today_bits} label can differ near your midnight.

Unknown tokens

A token chip for a name that does not exist shows the name in brackets, marked invalid. In typed text an unknown {name} stays exactly as you typed it. A valid token with nothing to fill in renders empty.

Finding tokens

Jump to a group:

Subscriber alert Cheer Tip Follow Raid Channel points Merch alert Giveaway alert Hype Train alert Goals Countdown Subathon Counter Latest events This session Session leaderboards Session chat Channel Calendar windows Rolling windows Channel totals Hype train Merch Now playing Viewer queue Ad breaks Giveaway

Goal tokens are the same on every Goal widget, whichever metric it counts, so they are listed once. Merch tokens need a connected Fourthwall shop.

Now playing, viewer queue, ad break and giveaway tokens appear in the picker once the matching chatbot module is on, and they render empty while it is off.

{pluspoints}, {pluspoints_level}, {pluspoints_next} and {pluspoints_threshold} refresh about every five minutes while you are live, and keep their last value between streams. {pluspoints}, {pluspoints_next} and {pluspoints_threshold} always show a number, on stream or off. {pluspoints_level} is the one that stays empty until Twitch has answered for your channel.

Subscriber alert

{name}

The person who just subscribed, or the person who received a gifted sub.

Shows
{name}→FerretKing
In your text
Welcome {name}!→Welcome FerretKing!The plainest sub alert.
{name} just went tier {tier} for {cumulative_months} months!→FerretKing just went tier 2 for 14 months!Tier and months read from the same alert.

On a gift, this is the person who received it. The gifter is {sender}.

{tier}

The sub tier: 1, 2, 3, or Prime.

Shows
{tier}→1
{months}

How many months this person has been subscribed in total.

Shows
{months}→4
{amount}

The number this alert is about: months on a resub, subs given on a gift bomb.

Shows
{amount}→4

Looking forTotal months subscribed is {cumulative_months}. On a gift bomb {amount} is the number of subs given instead.

{cumulative_months}

How many months in total this person has been subscribed.

Shows
{cumulative_months}→14

Looking forThe generic name for this number, used by variation rules, is {amount}.

{streak_months}

How many months in a row they have kept the sub going, when they share it.

Shows
{streak_months}→6
{duration_months}

How many months they paid for up front on this one purchase.

Shows
{duration_months}→1
{sub_variant}

Which kind of sub fired the alert: new, resub, prime, gifted or gifted_batch.

Shows
{sub_variant}→resub, so use it inside a variation rule rather than on screen
{gift_count}

How many subs were gifted at once. Empty on a normal sub.

Shows
{gift_count}→5, and nothing at all on a sub that was not gifted
In your text
{sender} gifted {gift_count} subs!→GenerousFerret gifted 5 subs!Only fills in on a gift batch, so write the alert for that case.
{gift_lifetime}

How many subs this gifter has given your channel over all time.

Shows
{gift_lifetime}→100
{message}

The message the subscriber typed with their resub, if they typed one.

Shows
{message}→thanks for the stream!
{sender}

The person who paid for the gift. Empty on a sub that was not gifted.

Shows
{sender}→GenerousFerret

Only fills in on gift subs. On a sub someone bought for themselves it renders empty.

{recipient}

The person who received the gift. Empty on a sub that was not gifted.

Shows
{recipient}→LuckyQuokka

Cheer

{name}

The person who cheered, or Anonymous when they hid their name.

Shows
{name}→FerretKing
{bits}

How many bits they cheered.

Shows
{bits}→500
In your text
{name} cheered {bits} bits!→blakkrazor69 cheered 500 bits!The plainest cheer alert.

Looking forThe generic name for this number, used by variation rules, is {amount}.

{amount}

How many bits they cheered, under the generic name variation rules compare on.

Shows
{amount}→500

Looking forThe bits cheered are {bits}. {amount} is the same number under the generic name.

{is_anonymous}

Reads true when the cheer was anonymous and false when it was not.

Shows
{is_anonymous}→false, so use it inside a variation rule rather than on screen
{message}

The message they typed alongside the cheer, if they typed one.

Shows
{message}→pog

Tip

{name}

The person who tipped.

Shows
{name}→FerretKing
{amount}

How much they tipped, as a plain number.

Shows
{amount}→12.00
In your text
Thanks for the ${amount}, {name}!→Thanks for the $12.00, Mmiwo!Type the currency symbol yourself so it lands where you want it.
{currency}

The currency code the tip came in, such as USD.

Shows
{currency}→USD
{message}

The note the tipper left, if they left one.

Shows
{message}→thanks!
In your text
{name} says "{message}"→Mmiwo says "thanks!"Renders empty when the tipper left no note.

Follow

{name}

The person who just followed.

Shows
{name}→FerretKing
In your text
Welcome in, {name}!→Welcome in, cdnkiffer!

Raid

{name}

The streamer who raided you.

Shows
{name}→FerretKing
{amount}

The raid size, under the generic name variation rules compare on.

Shows
{amount}→47

Looking forThe raid size is {viewers}. {amount} is the same number under the generic name.

{viewers}

How many viewers came across with the raid.

Shows
{viewers}→47
In your text
{name} raided with {viewers} friends!→sheikhyabootie raided with 47 friends!The raider and the raid size read from the same alert.

Looking forThe generic name for this number, used by variation rules, is {amount}.

Host

{name}

The streamer who hosted you.

Shows
{name}→FerretKing
{viewers}

How many viewers they had watching when they hosted.

Shows
{viewers}→12

Shoutout

{name}

The streamer you shouted out.

Shows
{name}→FerretKing
{viewers}

How many viewers that streamer had at the time.

Shows
{viewers}→125
{started_at}

When your shoutout cooldown for them runs out, as a timestamp.

Shows
{started_at}→2026-05-19T12:00:00Z

Channel points

{name}

The viewer who redeemed the reward.

Shows
{name}→PixelPhantum
{reward_title}

The name of the reward they redeemed.

Shows
{reward_title}→Hydrate
In your text
{name} redeemed {reward_title}→ninja redeemed HydrateThe plainest channel point alert.
{reward_cost}

How many channel points the reward costs.

Shows
{reward_cost}→1500

Looking forThe generic name for this number, used by variation rules, is {amount}.

{amount}

The point cost, under the generic name variation rules compare on.

Shows
{amount}→1500

Looking forThe point cost is {reward_cost}. {amount} is the same number under the generic name.

{user_input}

What the viewer typed when redeeming, on rewards that ask for text.

Shows
{user_input}→drink water you legend

Merch alert

{username}

The buyer name, only when they chose to share it. Usually empty.

Shows
{username}→NeonFan42
{product}

The first item in the order, the one to put in the headline.

Shows
{product}→Logo Hoodie

Looking forSame item, the first line of the order. Every item is {product_list}.

{first_product}

The first item in the order, the same item the headline uses.

Shows
{first_product}→Logo Hoodie

Looking forSame item as {product}. Every item is {product_list}.

{random_product}

One item picked at random out of the order.

Shows
{random_product}→Sticker Pack
{first_product_image}

A picture of the first item in the order.

Shows
{first_product_image}→https://cdn.overlaything.com/sample/hoodie.png
{product_list}

Every item in the order, separated by commas.

Shows
{product_list}→Logo Hoodie, Sticker Pack
In your text
{username} grabbed {product_list}!→NeonFan42 grabbed Logo Hoodie, Sticker Pack!Use this when an order can hold more than one item.
{item_count}

How many items were in the order.

Shows
{item_count}→2
{total}

What the order came to, as a plain number with no currency symbol.

Shows
{total}→35.00

Looking forA plain number for variation rules. On screen, use {total_display}.

{total_display}

What the order came to, with the currency symbol already in place.

Shows
{total_display}→$35.00

Already carries the currency symbol, so do not type one in front of it.

Looking forThe amount with its currency symbol. For a variation rule, use {total}.

{currency}

The currency symbol for the order, such as $.

Shows
{currency}→$
{matched_category}

The shop category this order matched, when you have categories set up.

Shows
{matched_category}→Apparel

Giveaway alert

{winner_name}

The viewer your giveaway draw picked.

Shows
{winner_name}→LuckyQuokka
In your text
{winner_name} wins {prize_name}!→LuckyQuokka wins Steam Gift Card!The winner and the prize read from the same alert.
{prize_name}

What the winner just won.

Shows
{prize_name}→Steam Gift Card
{prize_value}

What the prize is worth, as a plain number with no currency symbol.

Shows
{prize_value}→50.00

Looking forA plain number for variation rules. On screen, use {prize_value_display}.

{prize_value_display}

What the prize is worth, with the currency symbol already in place.

Shows
{prize_value_display}→$50.00

Looking forThe amount with its currency symbol. For a variation rule, use {prize_value}.

{currency}

The currency symbol for the prize value, such as $.

Shows
{currency}→$
{entry_count}

How many viewers were in the draw.

Shows
{entry_count}→128

Hype Train alert

{name}

The conductor, the viewer putting the most into this train.

Shows
{name}→PixelPaladin
{level}

The level the train just reached.

Shows
{level}→5
In your text
Hype Train level {level}! {progress} of {goal}→Hype Train level 5! 9500 of 15000The level with its progress bar numbers beside it.

Fires once per level, so an alert on this token plays again every time the train climbs.

{total}

Every point contributed to this train so far.

Shows
{total}→14250
{progress}

How many points into the current level the train is.

Shows
{progress}→9500
{goal}

How many points the current level needs before the train moves up.

Shows
{goal}→15000
{is_start}

Reads true on the alert that opens the train and false on every level after.

Shows
{is_start}→false, so use it inside a variation rule rather than on screen
{top_contributor_name}

The viewer who has put the most into this train.

Shows
{top_contributor_name}→PixelPaladin
{top_contributor_type}

How the top contributor got there: bits or subscription.

Shows
{top_contributor_type}→bits
{top_contributor_total}

How much the top contributor has put in, in bits or subs.

Shows
{top_contributor_total}→5000
{train_type}

Which kind of train Twitch started, such as regular.

Shows
{train_type}→regular
{is_golden_kappa}

Reads yes on a Golden Kappa train and no on a regular one.

Shows
{is_golden_kappa}→yes on a Golden Kappa train, no otherwise
{all_time_high_level}

The highest level any train on your channel has ever reached.

Shows
{all_time_high_level}→12
{all_time_high_total}

The most points any train on your channel has ever collected.

Shows
{all_time_high_total}→90000

Hype Train end

{name}

The viewer who finished the train as its conductor.

Shows
{name}→PixelPaladin
{level}

The level the train finished on.

Shows
{level}→32
In your text
The train finished at level {level} with {total} points!→The train finished at level 32 with 58900 points!The one alert that fires when the train is over.
{total}

Every point contributed across the whole train.

Shows
{total}→58900
{top_contributor_name}

The viewer who put the most into the train.

Shows
{top_contributor_name}→PixelPaladin
{top_contributor_type}

How the top contributor got there: bits or subscription.

Shows
{top_contributor_type}→subscription
{top_contributor_total}

How much the top contributor put in, in bits or subs.

Shows
{top_contributor_total}→12000
{train_type}

Which kind of train just finished, such as regular.

Shows
{train_type}→regular
{is_golden_kappa}

Reads yes when the train that just ended was a Golden Kappa train.

Shows
{is_golden_kappa}→no
{all_time_high_level}

The highest level any train on your channel has ever reached.

Shows
{all_time_high_level}→12
{all_time_high_total}

The most points any train on your channel has ever collected.

Shows
{all_time_high_total}→90000

Goals

{current}

How many subscribers you have so far in this goal's period.

Shows
{current}→42
In your text
{current} of {target} subs→42 of 100 subsThe two numbers side by side is the most common goal label.
{target}

The number you set as the goal.

Shows
{target}→100
{progress_pct}

How far along the goal is, as a percentage.

Shows
{progress_pct}→42, with no percent sign, so type the sign yourself
{remaining_to_target}

How many more you need to hit the target.

Shows
{remaining_to_target}→58
{metric_label}

The name of what the goal counts, ready to print.

Shows
{metric_label}→Subscribers
{period_label}

The window the goal counts over, ready to print.

Shows
{period_label}→This stream

Reads the period you picked on the widget, such as This stream or This month.

Countdown

{remaining}

How much time is left, formatted as hours, minutes and seconds.

Shows
{remaining}→00:29:13
In your text
Back in {remaining}→Back in 00:29:13The whole clock in one token, already formatted.

Place the hours, minutes and seconds separately with {remaining_h}, {remaining_m} and {remaining_s}.

{elapsed}

How much time has passed since the clock started.

Shows
{elapsed}→00:00:47
{target_time}

The moment the clock is counting down to.

Shows
{target_time}→2026-05-20T18:00:00Z
{remaining_h}

The hours part of the time left.

Shows
{remaining_h}→0
{remaining_m}

The minutes part of the time left.

Shows
{remaining_m}→29
{remaining_s}

The seconds part of the time left.

Shows
{remaining_s}→13
{is_finished}

Reads true once the clock hits zero and false while it is still running.

Shows
{is_finished}→false while the clock runs, true once it hits zero

Subathon

{remaining}

How much time is left, formatted as hours, minutes and seconds.

Shows
{remaining}→00:29:13
In your text
Subathon ends in {remaining}→Subathon ends in 00:29:13The whole clock in one token, already formatted.
{elapsed}

How much time has passed since the clock started.

Shows
{elapsed}→00:00:47
{target_time}

The moment the clock is counting down to.

Shows
{target_time}→2026-05-20T18:00:00Z
{remaining_h}

The hours part of the time left.

Shows
{remaining_h}→0
{remaining_m}

The minutes part of the time left.

Shows
{remaining_m}→29
{remaining_s}

The seconds part of the time left.

Shows
{remaining_s}→13
{is_finished}

Reads true once the clock hits zero and false while it is still running.

Shows
{is_finished}→false
{added_total}

Every second added to the clock so far this subathon.

Shows
{added_total}→1800, which is 30 minutes

The most recent addition on its own is {last_event_seconds}.

{last_event_seconds}

How many seconds the most recent event added to the clock.

Shows
{last_event_seconds}→300
{last_event_user}

The viewer whose sub, cheer or tip last added time.

Shows
{last_event_user}→FerretKing
In your text
{last_event_user} added {last_event_seconds} seconds!→ninja added 300 seconds!Names whoever last pushed the clock up.

Counter

{value}

What the counter is at right now.

Shows
{value}→42
In your text
{name}: {value}→deaths: 42The counter name and its number in one line.
{name}

The name of the counter, ready to print as a label.

Shows
{name}→deaths

Data labels

Latest events

{latest_follower}

Your most recent follower, with the @ already in front.

Shows
{latest_follower}→@cdnkiffer
In your text
Latest follower: {latest_follower}→Latest follower: @cdnkifferThe @ is already there, so do not type one.

Looking forThis one includes the @. Without it, use {latest_follower_name}.

{latest_follower_name}

Your most recent follower, with no @ in front.

Shows
{latest_follower_name}→cdnkiffer

Looking forNo @ on this one. With it, use {latest_follower}.

{latest_sub_name}

Your most recent subscriber.

Shows
{latest_sub_name}→originalmew
{latest_sub_tier}

The tier your most recent subscriber came in at.

Shows
{latest_sub_tier}→1
{latest_sub_months}

How many months your most recent subscriber has been subscribed.

Shows
{latest_sub_months}→7
{latest_sub_gifter}

Who paid for your most recent sub, when it was a gift.

Shows
{latest_sub_gifter}→duvalldoesthings
{latest_sub_gift_count}

How many subs the most recent gifter handed out at once.

Shows
{latest_sub_gift_count}→10
{latest_tipper}

Your most recent tipper.

Shows
{latest_tipper}→Mmiwo
{latest_tip_amount}

How much your most recent tipper sent.

Shows
{latest_tip_amount}→8.00
{latest_tip_message}

The note your most recent tipper left, if they left one.

Shows
{latest_tip_message}→Big fan, keep grinding!
In your text
Last tip: {latest_tipper} said "{latest_tip_message}"→Last tip: Mmiwo said "Big fan, keep grinding!"Renders empty when the tipper left no note.
{latest_cheer_name}

Your most recent cheerer.

Shows
{latest_cheer_name}→blakkrazor69
{latest_cheer_amount}

How many bits your most recent cheerer sent.

Shows
{latest_cheer_amount}→5000
{latest_raid_name}

The streamer who raided you most recently.

Shows
{latest_raid_name}→sheikhyabootie

Looking for{latest_raider} is the same value under its older name.

{latest_raid_amount}

How many viewers came across on your most recent raid.

Shows
{latest_raid_amount}→77
{latest_raider}

The streamer who raided you most recently.

Shows
{latest_raider}→sheikhyabootie

Looking forThe same raider. {latest_raid_name} is the name the Stream Data page shows you.

{latest_raid_viewers}

How many viewers came across on your most recent raid.

Shows
{latest_raid_viewers}→77
{latest_cheer_message}

The message your most recent cheerer typed, if they typed one.

Shows
{latest_cheer_message}→LET'S GO
{latest_redemption_name}

The viewer who redeemed a channel point reward most recently.

Shows
{latest_redemption_name}→FerretKing
{latest_redemption_reward}

The reward that was redeemed most recently.

Shows
{latest_redemption_reward}→Hydrate Now
{latest_redemption_cost}

How many channel points the most recent redemption cost.

Shows
{latest_redemption_cost}→500

This session

{session_followers}

New follows this stream.

Shows
{session_followers}→12
In your text
{session_followers} new followers today→18 new followers todayResets a few minutes after the stream ends.
{session_subs}

New and renewed subs this stream.

Shows
{session_subs}→4
{session_gift_subs}

Gifted subs this stream.

Shows
{session_gift_subs}→5
{session_bits}

Bits cheered this stream.

Shows
{session_bits}→5000
{session_tips_total}

Tips received, as an amount this stream.

Shows
{session_tips_total}→42.50
{session_tip_count}

How many tips came in this stream.

Shows
{session_tip_count}→3
{session_raid_viewers}

Viewers brought by raids this stream.

Shows
{session_raid_viewers}→412
{session_redemptions}

Channel point redemptions this stream.

Shows
{session_redemptions}→27

Session leaderboards

{session_top_tip}

The single biggest tip this stream, name and amount in one line.

Shows
{session_top_tip}→$8 Mmiwo
In your text
Top tip: {session_top_tip}→Top tip: $8 MmiwoThe name and the amount come as one string.

Looking forOne string with the name and the amount together. Place them separately with {session_top_tip_name} and {session_top_tip_amount}.

{session_top_tipper}

Whoever has tipped the most in total this stream, name and amount in one line.

Shows
{session_top_tipper}→$8 Mmiwo

Looking forOne string with the name and the amount together. Place them separately with {session_top_tipper_name} and {session_top_tipper_amount}.

{session_top_cheer}

The single biggest cheer this stream, name and bits in one line.

Shows
{session_top_cheer}→5000 blakkrazor69

Looking forOne string with the name and the bits together. Place them separately with {session_top_cheer_name} and {session_top_cheer_bits}.

{session_top_cheerer}

Whoever has cheered the most in total this stream, name and bits in one line.

Shows
{session_top_cheerer}→5000 blakkrazor69

Looking forOne string with the name and the bits together. Place them separately with {session_top_cheerer_name} and {session_top_cheerer_bits}.

{session_top_tip_name}

Who left the single biggest tip this stream.

Shows
{session_top_tip_name}→Mmiwo

Looking forJust the name. The name and amount together are {session_top_tip}.

{session_top_tip_amount}

How much the single biggest tip this stream was.

Shows
{session_top_tip_amount}→8.00

Looking forJust the amount. The name and amount together are {session_top_tip}.

{session_top_tipper_name}

Who has tipped the most in total this stream.

Shows
{session_top_tipper_name}→Mmiwo

Looking forJust the name. The name and amount together are {session_top_tipper}.

{session_top_tipper_amount}

How much your biggest tipper has sent in total this stream.

Shows
{session_top_tipper_amount}→8.00

Looking forJust the amount. The name and amount together are {session_top_tipper}.

{session_top_cheer_name}

Who sent the single biggest cheer this stream.

Shows
{session_top_cheer_name}→blakkrazor69

Looking forJust the name. The name and bits together are {session_top_cheer}.

{session_top_cheer_bits}

How many bits the single biggest cheer this stream was.

Shows
{session_top_cheer_bits}→5000

Looking forJust the bits. The name and bits together are {session_top_cheer}.

{session_top_cheerer_name}

Who has cheered the most in total this stream.

Shows
{session_top_cheerer_name}→blakkrazor69

Looking forJust the name. The name and bits together are {session_top_cheerer}.

{session_top_cheerer_bits}

How many bits your biggest cheerer has sent in total this stream.

Shows
{session_top_cheerer_bits}→5000

Looking forJust the bits. The name and bits together are {session_top_cheerer}.

Session chat

{session_top_chatter_name}

Whoever has sent the most chat messages this stream, bots excluded.

Shows
{session_top_chatter_name}→Doxmia

Needs chat analytics on and a live stream. Without them it renders empty.

{session_top_chatter_count}

How many messages your most active chatter has sent this stream.

Shows
{session_top_chatter_count}→57
{session_chat_messages}

How many chat messages your channel has seen this stream, bots excluded.

Shows
{session_chat_messages}→412

Channel

{game}

The category you are streaming right now.

Shows
{game}→Elden Ring
{title}

Your current stream title.

Shows
{title}→first playthrough, no spoilers
{viewers}

How many people are watching right now.

Shows
{viewers}→412

Updates about every 20 seconds, so it moves in steps rather than with every viewer.

{live}

Reads yes while you are live and no when you are not.

Shows
{live}→yes or no
{stream_started_at}

When this stream went live, as a full date and time.

Shows
{stream_started_at}→2026-09-05T18:00:00Z

Looking forThe moment you went live. How long ago that was is {uptime}.

{uptime}

How long you have been live this stream. Empty when you are offline.

Shows
{uptime}→2h 14m, and nothing at all when you are offline
In your text
Live for {uptime}→Live for 2h 14mRenders empty off stream, so pair it with {live} if the line should disappear.

Looking forHow long you have been live. The moment you went live is {stream_started_at}.

{tags}

Your current stream tags, separated by commas.

Shows
{tags}→English, Souls
{chatters}

How many people are in your chat right now.

Shows
{chatters}→42

Refreshed about every 5 minutes while you are live. Empty when the chatter list cannot be read.

{streamer}

Your channel display name.

Shows
{streamer}→doxmia
{channel_url}

A link to your channel.

Shows
{channel_url}→https://twitch.tv/doxmia
{livesince}

When this stream went live, in your Bot settings time zone and date format.

Shows
{livesince}→Sep 5, 2026

Looking forThe time you went live, written out. How long ago that was is {uptime}, and the raw timestamp is {stream_started_at}.

{pluspoints}

Your Plus Points so far this month. Twitch's own figure when your channel is in the Plus Program, a close count otherwise.

Shows
{pluspoints}→812

Refreshed about every five minutes while you are live, and it keeps its last value between streams.

{pluspoints_level}

Your Plus Program level as Twitch has it: 0, 1 or 2. Your standing, not this month's total. Empty until Twitch has answered for your channel.

Shows
{pluspoints_level}→1

Your standing in the Plus Program, not this month total. This is the one that stays empty until Twitch has answered for your channel.

{pluspoints_next}

How many Plus Points you still need to reach your Plus Points goal. Always a number, on stream or off.

Shows
{pluspoints_next}→47

Counts down to the goal on your Plus Points bar, and sits at 0 once you reach it. Always a number, on stream or off.

{pluspoints_threshold}

The Plus Points goal you are working toward. Always a number: Twitch’s own when it has answered, otherwise worked out from your count.

Shows
{pluspoints_threshold}→100

The goal you picked on your Plus Points page, or the next one above your total if you have not picked one. Twitch’s own figure when it has answered, otherwise worked out from your count.

Looking forA number you typed yourself belongs on a Goal widget. This one is Twitch's own threshold for {pluspoints}.

Calendar windows

{today_followers}

New follows today. Updates about every 5 minutes while you are live.

Shows
{today_followers}→12
{today_subs}

New and renewed subs today. Updates about every 5 minutes while you are live.

Shows
{today_subs}→4
{today_gift_subs}

Gifted subs today. Updates about every 5 minutes while you are live.

Shows
{today_gift_subs}→5
{today_bits}

Bits cheered today. Updates about every 5 minutes while you are live.

Shows
{today_bits}→5000
{today_tips_total}

Tips received, as an amount today. Updates about every 5 minutes while you are live.

Shows
{today_tips_total}→42.50
{today_tip_count}

How many tips came in today. Updates about every 5 minutes while you are live.

Shows
{today_tip_count}→3
{today_raid_viewers}

Viewers brought by raids today. Updates about every 5 minutes while you are live.

Shows
{today_raid_viewers}→412
{today_redemptions}

Channel point redemptions today. Updates about every 5 minutes while you are live.

Shows
{today_redemptions}→27
{week_followers}

New follows this week. Updates about every 5 minutes while you are live.

Shows
{week_followers}→12

Looking forThis calendar week, in your Bot settings time zone. For the last 7 days, use {7d_followers}.

{week_subs}

New and renewed subs this week. Updates about every 5 minutes while you are live.

Shows
{week_subs}→4

Looking forThis calendar week, in your Bot settings time zone. For the last 7 days, use {7d_subs}.

{week_gift_subs}

Gifted subs this week. Updates about every 5 minutes while you are live.

Shows
{week_gift_subs}→5
{week_bits}

Bits cheered this week. Updates about every 5 minutes while you are live.

Shows
{week_bits}→5000
{week_tips_total}

Tips received, as an amount this week. Updates about every 5 minutes while you are live.

Shows
{week_tips_total}→42.50
{week_tip_count}

How many tips came in this week. Updates about every 5 minutes while you are live.

Shows
{week_tip_count}→3
{week_raid_viewers}

Viewers brought by raids this week. Updates about every 5 minutes while you are live.

Shows
{week_raid_viewers}→412
{week_redemptions}

Channel point redemptions this week. Updates about every 5 minutes while you are live.

Shows
{week_redemptions}→27
{month_followers}

New follows this month. Updates about every 5 minutes while you are live.

Shows
{month_followers}→12
{month_subs}

New and renewed subs this month. Updates about every 5 minutes while you are live.

Shows
{month_subs}→4
{month_gift_subs}

Gifted subs this month. Updates about every 5 minutes while you are live.

Shows
{month_gift_subs}→5
{month_bits}

Bits cheered this month. Updates about every 5 minutes while you are live.

Shows
{month_bits}→5000
{month_tips_total}

Tips received, as an amount this month. Updates about every 5 minutes while you are live.

Shows
{month_tips_total}→42.50
{month_tip_count}

How many tips came in this month. Updates about every 5 minutes while you are live.

Shows
{month_tip_count}→3
{month_raid_viewers}

Viewers brought by raids this month. Updates about every 5 minutes while you are live.

Shows
{month_raid_viewers}→412
{month_redemptions}

Channel point redemptions this month. Updates about every 5 minutes while you are live.

Shows
{month_redemptions}→27

Rolling windows

{7d_followers}

New followers in the last 7 days, counting back from right now.

Shows
{7d_followers}→121
In your text
{7d_followers} new followers this week!→121 new followers this week!Always the last 7 days, not Monday to Sunday.

Updates about once an hour, so it moves in steps rather than on every follow.

Looking forAlways the last 7 days, ending now. For this calendar week, use {week_followers}.

{30d_followers}

New followers in the last 30 days, counting back from right now.

Shows
{30d_followers}→372
{7d_subs}

New subs in the last 7 days, counting back from right now.

Shows
{7d_subs}→24

Looking forAlways the last 7 days, ending now. For this calendar week, use {week_subs}.

{30d_subs}

New subs in the last 30 days, counting back from right now.

Shows
{30d_subs}→135

Channel totals

{follower_total}

Every follower your channel has ever had. Updates about every 5 minutes while you are live.

Shows
{follower_total}→116546

This is the running total your Goals tab shows. Your Twitch follower count is {total_followers}.

{sub_total}

Every subscription your channel has ever had. Updates about every 5 minutes while you are live.

Shows
{sub_total}→23384
{tip_total}

Every dollar your channel has ever been tipped. Updates about every 5 minutes while you are live.

Shows
{tip_total}→19227.65
{cheer_total}

Every bit your channel has ever been cheered. Updates about every 5 minutes while you are live.

Shows
{cheer_total}→1922517
{total_subs}

How many active subscribers your channel has right now.

Shows
{total_subs}→185

Looking forBoth show your current subscriber count. {current_subs} is the clearer name.

{current_subs}

How many active subscribers your channel has right now.

Shows
{current_subs}→185
In your text
{current_subs} subs strong→185 subs strongYour active subscriber count, not a lifetime figure.

Looking for{total_subs} is the same number under an older name.

{total_followers}

How many followers your channel has right now.

Shows
{total_followers}→76932
{total_cheers}

Every bit ever cheered on your channel, added up.

Shows
{total_cheers}→2643690

Looking forAll-time bits. {total_bits} is the same number under a shorter name.

{total_bits}

Every bit ever cheered on your channel, added up.

Shows
{total_bits}→2643690

Looking forAll-time bits. {total_cheers} is the same number under its older name.

{total_tips}

Every tip your channel has ever taken, added up.

Shows
{total_tips}→65231.94
{total_gift_subs}

Gifted subs all time.

Shows
{total_gift_subs}→5
{total_tip_count}

How many tips came in all time.

Shows
{total_tip_count}→3
{total_raid_viewers}

Viewers brought by raids all time.

Shows
{total_raid_viewers}→412
{total_redemptions}

Channel point redemptions all time.

Shows
{total_redemptions}→27

Hype train

{hype_train_active}

Reads yes while a Hype Train is running and no the rest of the time.

Shows
{hype_train_active}→yes while a train runs, no otherwise

The level and totals stay on screen after the train ends, so pair them with this token if you want the readout to disappear.

{hype_train_level}

The level the running Hype Train is on.

Shows
{hype_train_level}→5
{hype_train_progress}

How many points into the current level the running train is.

Shows
{hype_train_progress}→9500
{hype_train_goal}

How many points the current level needs before the train moves up.

Shows
{hype_train_goal}→15000
{hype_train_total}

Every point contributed to the running train so far.

Shows
{hype_train_total}→14250
{hype_train_conductor}

The viewer putting the most into the running train.

Shows
{hype_train_conductor}→PixelPaladin
{hype_train_type}

Which kind of train is running, such as regular.

Shows
{hype_train_type}→regular

Merch

{session_merch_sales}

How many shop orders came in since this stream started.

Shows
{session_merch_sales}→12

Only offered once a Fourthwall shop is connected under Integrations.

{session_merch_revenue}

How much your shop took since this stream started.

Shows
{session_merch_revenue}→349.50
{latest_merch_product}

The item in your most recent shop order.

Shows
{latest_merch_product}→Logo Hoodie
{alltime_merch_sales}

How many shop orders your channel has taken over all time.

Shows
{alltime_merch_sales}→47
{alltime_merch_revenue}

How much your shop has taken over all time.

Shows
{alltime_merch_revenue}→1230.75

Now playing

{media_current}

The song playing right now, with who asked for it.

Shows
{media_current}→Blinding Lights - requested by ninja
In your text
Now playing: {media_current}→Now playing: Blinding Lights - requested by ninjaEmpty when nothing is playing, so the line reads cleanly.

Needs the Media Request module turned on.

Looking forJust the song title, with nothing else, is {media_current_title}.

{media_current_title}

Just the title of the song playing right now.

Shows
{media_current_title}→Blinding Lights

Looking forThe title with who requested it is {media_current}.

{media_current_artist}

The channel or artist the current song came from.

Shows
{media_current_artist}→The Weeknd
{media_current_url}

A link to the song playing right now.

Shows
{media_current_url}→https://youtu.be/abc123
{media_requester}

Who requested the current song. Empty for a playlist track.

Shows
{media_requester}→ninja
{media_next}

The next song in the request queue.

Shows
{media_next}→Levitating
{media_count}

How many requested songs are waiting to play.

Shows
{media_count}→3

Viewer queue

{queue_current}

The viewer whose turn it is right now.

Shows
{queue_current}→ninja

Looking forWhose turn it is now. The one after them is {queue_next}.

{queue_next}

The next viewer waiting in the queue.

Shows
{queue_next}→cohhcarnage

Looking forWho is up next. Whose turn it is right now is {queue_current}.

{queue_count}

How many viewers are waiting in the queue.

Shows
{queue_count}→7
{queue_list}

The next few viewers waiting, separated by commas.

Shows
{queue_list}→up to five names, comma separated

Needs the Queue module turned on.

Ad breaks

{ad_nextin}

How long until your next scheduled ad break.

Shows
{ad_nextin}→4m 30s

Refreshed every 20 seconds, so it counts down in steps rather than second by second.

Looking forHow long until the next break. How long the break itself runs is {ad_duration}.

{ad_lastago}

How long ago your last ad break ran.

Shows
{ad_lastago}→12m
{ad_duration}

How long the current or most recent ad break is.

Shows
{ad_duration}→1 min 30 secs

Looking forHow long the break runs. How long until it starts is {ad_nextin}.

{ad_snoozecount}

How many ad snoozes you have left today.

Shows
{ad_snoozecount}→2
{ad_prerollfree}

Seconds of preroll-free time your channel has banked.

Shows
{ad_prerollfree}→300

Giveaway

{giveaway_open}

Reads yes while a giveaway is taking entries.

Shows
{giveaway_open}→yes or no
{giveaway_entries}

How many viewers have entered the running giveaway.

Shows
{giveaway_entries}→128

This is the live count while entries are open. The giveaway alert carries its own entry count for the finished draw.

Looking forEntries in the giveaway running now. Whether it is still taking them is {giveaway_open}.

{giveaway_prize}

The prize for the running giveaway.

Shows
{giveaway_prize}→Steam Gift Card
{giveaway_keyword}

What a viewer types in chat to enter, exactly as they type it.

Shows
{giveaway_keyword}→!enter

Related

  • Keyboard shortcuts
  • FAQ
  • Troubleshooting
Previous Import from StreamElements Next Keyboard shortcuts
On this page
Ask the docs
Have a question?
Thinking it through...
Answer
Get an answer instantly; our model is trained on every feature of our streaming suite.
ESC
Get started
More than overlaysOverlayThing is an all-in-one toolkit for your Twitch channel: a visual overlay … Get started From zero to liveThe fastest path to a working overlay on your stream. Sign in, build something, … Get started Add to your streamOne overlay, one URL, one browser source. OverlayThing works with any streaming … Get started
Overlays
OverlaysYour overlays live on the Overlays page, a gallery of every canvas you have buil… Overlays The editorWhere overlays are built. A canvas in the middle, your layer stack on the left, … Overlays Overlay URLsEach overlay has its own private URL. Add it to your streaming software once and… Overlays Alert queueWhen events pile up (a gifted-sub train, a hype raid), you usually want alerts t… Overlays Share, export & importMove overlays and individual widgets between your own overlays, back them up as … Overlays
Widgets
Widgets overviewWidgets are the building blocks of an overlay. Some fire on an event and leave (… Widgets AlertsThe moment something happens, an alert fires on screen with motion, sound and yo… Widgets VariationsOne event, different reactions. Variations let a single alert play a bigger vers… Widgets Hype TrainWhen a Hype Train rolls on your channel, OverlayThing can fire an on-screen aler… Widgets Text to speechHave alerts read messages aloud: a tip note, a resub message, a redemption. Text… Widgets GoalsA progress bar with a target. It fills itself as events come in, and you can cel… Widgets Countdown & subathonTwo timer widgets. A countdown runs down to a time or for a set duration. A suba… Widgets Chat boxPut your Twitch chat on stream, great for handheld, IRL or face-cam layouts wher… Widgets Data labelsSmall live readouts that keep your channel numbers on screen: latest follower, l… Widgets CounterPut a live number on your overlay: deaths, wins, fails, anything you keep a runn… Widgets Text, image & videoThe plain building blocks. Use them for backgrounds, frames, logos, panels and l… Widgets
Chatbot
The chatbotA Twitch chat bot built into OverlayThing: custom commands, timers, counters, qu… Chatbot Getting startedTurn the bot on, make it a moderator, and pick your command prefix. Three small … Chatbot CommandsCommands are the heart of the bot. A viewer types a trigger, the bot replies wit… Chatbot VariablesVariables are $( … ) tokens you drop into a command response. They fill in with … Chatbot ConditionalsConditionals let one command react differently to different viewers and situatio… Chatbot RecipesCopy-ready command responses for the trickier variables: shoutouts, weather, dic… Chatbot API commandsPower-user territory. Wire a command to an external API and pull a live value in… Chatbot IntegrationsBuilt-in connections to outside services that add ready-made variables. Today th… Chatbot Command API & Copy-URLFire bot commands and module actions from outside chat: a Stream Deck button, a … Chatbot Chat moderationWhen the bot is a moderator it can keep chat clean automatically: tunable spam f… Chatbot Bot accountChoose which Twitch account the bot posts as: the shared OverlayThing bot, your … Chatbot Bot settingsThe channel-wide behavior of the bot: your prefix, how it replies, how cooldowns… Chatbot
Chatbot modules
ModulesThe bot is built from modules you switch on one at a time. Turn on only what you… Chatbot modules TimersPost recurring messages on a schedule: rules, your socials, a sponsor plug. Time… Chatbot modules CountersTrack a number from chat: deaths, wins, fails, anything you want to tally live.… Chatbot modules QuotesA searchable quote book your chat builds with you, one memorable line at a time.… Chatbot modules Chat alertsPost a chat message when someone follows, subscribes, resubs, gifts, cheers or r… Chatbot modules WelcomeGreet people automatically: first-time chatters, returning regulars, and incomin… Chatbot modules Ad BreaksHave the bot speak up around your ad breaks: a heads-up before they hit, a line … Chatbot modules GiveawaysRun a giveaway and draw a winner from chat, by keyword entry or passive presence… Chatbot modules QueueLet viewers line up to play with you. They join, you pull people up in order.… Chatbot modules Song requestsViewers request YouTube songs by name or link and the bot builds a play queue, w… Chatbot modules LoyaltyTrack how long your viewers watch, so you can spot and reward your most loyal re… Chatbot modules
Flows
FlowsFlows let you wire your channel together with no code. Pick something that happe… Flows Build a flowYou build a flow on a canvas: add nodes, connect them in the order they should r… Flows TriggersA trigger is the event that starts a flow. Every flow has at least one. Most tri… Flows ConditionsConditions are the rules in a flow. They decide whether the run keeps going and … Flows ActionsActions are the things a flow does. Most of what the rest of the platform can do… Flows Using dataThe best flows feel personal because they use the real details of the event. Dro… Flows ExamplesFour flows from simple to advanced, drawn as the real graphs you build on the ca… Flows
Channel Rewards
Channel RewardsCreate channel-point rewards through OverlayThing and your flows can do things T… Channel Rewards
Remote Control
Remote ControlDrive your local OBS Studio or Meld Studio straight from OverlayThing. Switch sc… Remote Control Connect OBS StudioAdd the Remote Control URL as a dock or browser source, enable the OBS WebSocket… Remote Control Connect Meld StudioAdd the blank Remote Control source to every Meld scene. There is no password to… Remote Control Bindings & triggersA binding is one or more actions plus the trigger that fires them. Build them on… Remote Control Security & accessThe Remote Control URL is a key to your streaming software, and your OBS passwor… Remote Control
OBS Dock
OBS DockChat, activity, media requests and stream controls in a panel docked inside OBS.… OBS Dock Layouts & displayBuild the dock out of panes, save arrangements as layouts, and open a second doc… OBS Dock Chat & Needs YouRead and send chat as yourself, moderate from the message row, and clear AutoMod… OBS Dock Activity & mediaEvery channel event in one filterable feed, and full control of the media queue … OBS Dock Stream info & controlsEdit your title, category and tags without leaving OBS, and run markers, clips, … OBS Dock
Companion
CompanionA native desktop app for macOS and Windows that pairs with your OverlayThing acc… Companion Install & pairDownload the Companion for your operating system, open it, and approve one short… Companion Feed, chat & channelThe Companion mirrors the parts of your dashboard you touch mid-stream, on your … Companion ScriptingWrite small scripts that react to your stream and do things only a local app can… Companion The scripting APIThe complete ot surface: every event you can listen to, every action you can tak… Companion Permissions & securityScripts run in a sandbox and start with zero powers. You grant each capability p… Companion
Monetize
Your tip pageA branded donation page viewers can reach from a single link in your panels or c… Monetize Tip settingsEverything behind your tip page: the payment connections, your branding, the amo… Monetize Merch with FourthwallConnect your Fourthwall shop and merch sales fire alerts on stream, the same way… Monetize
Build your own
Describe & BuildDescribe the widget you want in plain language and OverlayThing builds a styled,… Build your own Custom widgetsFor when you want to break the mold. Write your own HTML, CSS and JavaScript, re… Build your own Widget SDKThe API your custom widgets use to receive live events and persist state. It is … Build your own
Your data
DashboardYour home base. The numbers that matter at a glance, a chart to spot trends, and… Your data Stream dataThe numbers behind your overlay. Labels, goals and leaderboards all read from he… Your data Chat logA searchable archive of your chat, events and moderation actions. Look up what a… Your data ModerationEvery chat message, tip note and alert message runs through a moderation pipelin… Your data
Account
Settings & connectionsYour account, your connected services, and the controls that protect your access… Account Export your dataYour data is yours. From Settings, under Data and privacy, you can take it with … Account Import from StreamElementsAlready set up elsewhere? Bring your overlays, alert settings, goals and history… Account
Reference
Label tokensTokens are {placeholders} you drop into alert text, label templates and goal lab… Reference Keyboard shortcutsThe editor is built for the keyboard. These are the ones worth learning.… Reference FAQShort answers to the questions we hear most. For step-by-step fixes when somethi… Reference TroubleshootingQuick fixes for the things that trip people up most.… Reference
↑↓ navigate ⏎ open esc close