Skip to main content

Platform Variables

Use variables as placeholders inside Lumia messages, alerts, and overlays. Write them like {{username}} or {{amount}}, and Lumia replaces them with live data when the event runs.

Quick start

Pick a platform tab, then look in the section that matches where you want to use the variable.

  • Available everywhere: broadly usable platform variables.
  • Chat and commands: variables for chat messages, commands, redeems, and chatbot actions.
  • Alerts and events: variables that only exist for a specific alert or event.
Examples
You writeWhat users see
Thanks {{username}}!Thanks LumiaStream!
You tipped {{currencySymbol}}{{amount}}You tipped $5
Latest message: {{message}}Latest message: Great stream

Alert Explorer

If you are building a custom overlay, open a platform tab and use the alert explorer to inspect the exact alert name, the data.extraSettings.* fields it returns, and the matching template variables. For the full AlertEvent type, see Overlay Type Definitions.

How alert variables map to Overlay.on('alert')

In alert templates, variables like {{username}}, {{amount}}, and {{stickerName}} are the same values your overlay receives inside data.extraSettings.

In alert text / templatesIn Overlay.on('alert')Notes
{{username}}data.extraSettings.usernameMost common payload mapping.
{{amount}}data.extraSettings.amountPresent on alerts that carry an amount.
{{stickerId}}data.extraSettings.stickerIdExample: YouTube Super Sticker.
{{stickerName}}data.extraSettings.stickerNameHuman-readable sticker label.
Variation valuedata.dynamic.valueUse this for alert variation matching, not for general overlay payload access.

Rule of thumb: if you see an alert variable on this page, read it from data.extraSettings.variableName in Overlay.on('alert').

Lumiastream

Variables only work when the event provides that data. Global variables are broadly available. Chat and alert variables only work in those specific contexts.

Available everywhere

These are the safest variables to use across the selected platform. This table includes sample output values.

VariableMeaningUse it likeExample values
{{read_file}}Read from a file on your local computer in plain text, e.g. {{read_file=C:\User\Myfile.txt}}{{read_file}}Hello from notes.txt
{{read_url}}Read from a simple GET url. This has a timeout of 2 seconds by default and will display the body of the request in plain text, e.g. {{read_url=https://api.lumiastream.com/api/url-test}}{{read_url}}OK
{{selection}}Allows chat to choose based on defined selections, e.g. {{selection=first,second,third}}{{selection}}Option A
{{random}}Randomly choose between two numbers, e.g. {{random=1,20}}{{random}}7
{{random_input}}Randomly choose between different inputs separated by a comma, e.g. {{random_input=first,second,third}}{{random_input}}Blue
{{math}}Evaluate a math expression using +, -, *, /, %, ^ and parentheses, e.g. {{math={{var1}}+{{var2}}}}{{math}}42
{{js}}Evaluate a JavaScript expression in a secure sandbox, e.g. {{js=10 * {{var1}}}}{{js}}No example yet
{{compare}}Compare two values and return true/false. Supports >, >=, <, <=, ==, !=, e.g. {{compare={{var1}},>,{{var2}}}}{{compare}}true
{{round}}Round a number to a specific amount of decimals, e.g. {{round={{math={{var1}}/{{var2}}}},2}}{{round}}4
{{if}}Return one value when true and another when false, e.g. {{if={{compare={{var1}},>,10}},high,low}}{{if}}Online
{{coalesce}}Return the first non-empty value, e.g. {{coalesce={{display_name}},{{username}},Anonymous}}{{coalesce}}Fallback value
{{between}}Check if a value is between min and max and return true/false, e.g. {{between={{var1}},10,50}}{{between}}15
{{min}}Return the smallest numeric value from inputs, e.g. {{min={{v1}},{{v2}},100}}{{min}}3
{{max}}Return the largest numeric value from inputs, e.g. {{max={{v1}},{{v2}},100}}{{max}}9
{{regex_extract}}Extract text from a value using regex and group index, e.g. {{regex_extract={{message}},([0-9]+),1}}{{regex_extract}}12345
{{replace}}Replace text in a value using plain text or regex, e.g. {{replace={{message}},badword,***}}{{replace}}Hello Lumia
{{format_date}}Format a date/time value with a pattern, e.g. {{format_date={{session_start_date}},MM/DD/YYYY hh:mm A}}{{format_date}}Mar 15, 2026 9:00 AM
{{time_since}}Return elapsed time since a date in a short format, e.g. {{time_since={{follow_time}}}}{{time_since}}5 minutes ago
{{sum_variables}}Sum multiple variables together to create a combined value. This is very useful for creating a combined goal like followers, e.g. {{sum_variables=twitch_total_follower_count,kick_total_follower_count}}{{sum_variables}}42
{{offset_count}}Offset the count of a variable by a number, e.g. {{offset_count=twitch_total_follower_count,10}}{{offset_count}}3
{{get_commands}}Get all commands and chatbot commands that the user who triggered the command can use, e.g. {{get_commands}}{{get_commands}}!lights,!brb,!discord
{{get_all_commands}}Get all commands and chatbot commands that are on e.g. {{get_all_commands}}{{get_all_commands}}!lights,!brb,!discord,!song
{{convert_color_to_hex}}Converts a generic color from our colors list to hex. If the color is already hex it will keep it a hex color, e.g. {{convert_color_to_hex=green}}{{convert_color_to_hex}}#FF4076
{{get_latest_file_from_folder}}Gets the latest file from a folder. e.g. {{get_latest_file_from_folder=C:/Users/Desktop}}.{{get_latest_file_from_folder}}/Users/name/Videos/latest.mp4
{{get_random_file_from_folder}}Gets a random file from a folder. e.g. {{get_random_file_from_folder=C:/Users/Desktop}}.{{get_random_file_from_folder}}/Users/name/Videos/random.mp4
{{screenshot}}Take a screenshot of your desktop and store it on your computer. You can also select the monitor by selecting the number after the variable. e.g. {{screenshot}}. Or to select the second monitor: {{screenshot=2}}{{screenshot}}https://cdn.example.com/screenshot.png
{{get_queue_count}}The current count of items in queue. e.g. {{get_queue_count}}{{get_queue_count}}5
{{get_var_from_msg}}Gets the value of a variable from a message. Use an equal sign within the message to assign a variable and a comma to separate multiple variables. e.g. !command name=lumi, age=6. var will be: {{get_var_from_msg=name}} and {{get_var_from_msg=age}}{{get_var_from_msg}}lumiastream
{{get_user_loyalty_points}}Get the loyalty points value of a user. e.g. variable will be: {{get_user_loyalty_points={{message}}}}, or viewer's username and platform {{get_user_loyalty_points={{username}},{{platform}}}}. Then use it like this: !command username or !command username,platform. Result will be the point ballance without currency{{get_user_loyalty_points}}1250
{{translate}}Translate a message using Google Translate. e.g. {{translate={{message}}}} or {{translate={{message}}|es}}{{translate}}Hello world
{{commands_url}}Commands URL page for list of commands{{commands_url}}https://example.com
{{session_start_date}}The time the session started: {{session_start_date}}{{session_start_date}}2026-03-15T09:00:00Z
{{game_last_player}}Last player to trigger a game{{game_last_player}}Just Chatting
{{today}}Current date without the time. Optional IANA timezone: {{today=America/New_York}}{{today}}No example yet
{{lumia_uptime}}The time Lumia has been started for: {{lumia_uptime}}{{lumia_uptime}}2h 14m
{{lumia_uptime_timestamp}}Timestamp of when your stream went live, e.g. {{lumia_uptime_timestamp}}{{lumia_uptime_timestamp}}2h 14m
{{twitch_uptime_timestamp}}(Twitch) Live start timestamp{{twitch_uptime_timestamp}}2h 14m
{{youtube_uptime_timestamp}}(YouTube) Live start timestamp{{youtube_uptime_timestamp}}2h 14m
{{facebook_uptime_timestamp}}(Facebook) Live start timestamp{{facebook_uptime_timestamp}}2h 14m
{{kick_uptime}}(Kick) Stream uptime{{kick_uptime}}2h 14m
{{kick_uptime_timestamp}}(Kick) Live start timestamp{{kick_uptime_timestamp}}2h 14m
{{tiktok_uptime}}(TikTok) Stream uptime{{tiktok_uptime}}2h 14m
{{tiktok_uptime_timestamp}}(TikTok) Live start timestamp{{tiktok_uptime_timestamp}}2h 14m
{{overlays_brb_clips}}Overlays brb clips urls list separated by a comma{{overlays_brb_clips}}No example yet
{{latest_donator}}Last person to donate{{latest_donator}}lumiastream
{{latest_donator_amount}}Last person to donate amount{{latest_donator_amount}}25.00
{{latest_donator_currency}}Last person to donate currency{{latest_donator_currency}}USD
{{latest_donator_currency_symbol}}Last person to donate currency symbol{{latest_donator_currency_symbol}}$
{{session_top_donator}}Top person in this session to donate{{session_top_donator}}lumiastream
{{session_top_donator_amount}}Top person in this session to donate amount{{session_top_donator_amount}}25.00
{{session_top_donator_currency}}Top person in this session to donate currency{{session_top_donator_currency}}USD
{{session_top_donator_currency_symbol}}Top person in this session to donate currency symbol{{session_top_donator_currency_symbol}}$
{{top_donator}}All time top person to donate{{top_donator}}lumiastream
{{top_donator_amount}}All time top person to donate amount{{top_donator_amount}}25.00
{{top_donator_currency}}All time top person to donate currency{{top_donator_currency}}USD
{{top_donator_currency_symbol}}All time top person to donate currency symbol{{top_donator_currency_symbol}}$
{{top_donator_list_amount}}Top 10 list of people to donate amount{{top_donator_list_amount}}25.00
{{top_donator_list_currency}}Top 10 list of people to donate currency{{top_donator_list_currency}}USD
{{top_donator_list_currency_symbol}}Top 10 list of people to donate currency symbol{{top_donator_list_currency_symbol}}$
{{total_donation_amount}}Total tips{{total_donation_amount}}25.00
{{total_donation_amount_currency}}Total tips currency{{total_donation_amount_currency}}USD
{{total_donation_amount_currency_symbol}}Total tips currency symbol{{total_donation_amount_currency_symbol}}$
{{session_donation_amount}}Session tip{{session_donation_amount}}25.00
{{session_donation_amount_currency}}Session tip currency{{session_donation_amount_currency}}USD
{{session_donation_amount_currency_symbol}}Session tip currency symbol{{session_donation_amount_currency_symbol}}$
{{donation_count}}All time tip count{{donation_count}}42
{{session_donation_count}}Session tip count{{session_donation_count}}42
{{session_donator_list}}Session donator list{{session_donator_list}}lumiastream,rgblumia
{{session_donator_list_with_amount}}Session donator list with amount{{session_donator_list_with_amount}}25.00
{{week_donation_amount}}Donation total for the current calendar week{{week_donation_amount}}25.00
{{month_donation_amount}}Donation total for the current calendar month{{month_donation_amount}}25.00
{{week_donation_count}}Donation count for the current calendar week{{week_donation_count}}42
{{month_donation_count}}Donation count for the current calendar month{{month_donation_count}}42
{{week_top_donator}}Top donator for the current calendar week{{week_top_donator}}lumiastream
{{week_top_donator_amount}}No description available yet.{{week_top_donator_amount}}25.00
{{week_top_donator_list}}Top donators this week list{{week_top_donator_list}}lumiastream,rgblumia
{{week_top_donator_list_amount}}Amounts for the top donators this week list{{week_top_donator_list_amount}}25.00
{{month_top_donator}}Top donator for the current calendar month{{month_top_donator}}lumiastream
{{month_top_donator_amount}}No description available yet.{{month_top_donator_amount}}25.00
{{month_top_donator_list}}Top donators this month list{{month_top_donator_list}}lumiastream,rgblumia
{{month_top_donator_list_amount}}Amounts for the top donators this month list{{month_top_donator_list_amount}}25.00
{{raffle_title}}Title of the raffle{{raffle_title}}Lumiastream Stream Live
{{raffle_description}}Description of the raffle{{raffle_description}}Going live with alerts and lights
{{raffle_entries}}Raffle entries list separated by comma e.g user1,user2,user3{{raffle_entries}}lumiastream,rgblumia
{{raffle_generated_number}}The number that has been selected for the raffle{{raffle_generated_number}}No example yet
{{raffle_entries_count}}Raffle entries count{{raffle_entries_count}}42
{{raffle_winners}}All of the usernames of users who won the raffle (Comma separated){{raffle_winners}}lumiastream
{{raffle_type}}Type of raffle{{raffle_type}}No example yet
{{raffle_winner}}Username of user who won the raffle{{raffle_winner}}lumiastream
{{raffle_winner_avatar}}Avatar of user who won the raffle{{raffle_winner_avatar}}https://cdn.example.com/image.png
{{raffle_entry_command}}Command that enters a user into the raffle{{raffle_entry_command}}No example yet
{{tournament_title}}Tournament title{{tournament_title}}Lumiastream Stream Live
{{tournament_description}}Tournament description{{tournament_description}}Going live with alerts and lights
{{tournament_game}}Tournament game{{tournament_game}}Just Chatting
{{tournament_format}}Tournament format{{tournament_format}}No example yet
{{tournament_state}}Tournament state{{tournament_state}}No example yet
{{tournament_participants_count}}Tournament participants count{{tournament_participants_count}}42
{{tournament_entry_command}}Command used to enter the tournament{{tournament_entry_command}}No example yet
{{tournament_winner}}Tournament winner{{tournament_winner}}lumiastream
{{tournament_winner_avatar}}Tournament winner avatar URL{{tournament_winner_avatar}}https://cdn.example.com/image.png
{{viewerqueue_title}}Viewer queue title{{viewerqueue_title}}Lumiastream Stream Live
{{viewerqueue_entry_command}}Viewer queue entry command e.g: !joinq{{viewerqueue_entry_command}}No example yet
{{viewerqueue_entries}}Viewer queue entries list separated by comma e.g viewer1,viewer2,viewer3{{viewerqueue_entries}}lumiastream,rgblumia
{{viewerqueue_players}}Viewer queue selected players list separated by comma e.g player1,player2,player3{{viewerqueue_players}}lumiastream,rgblumia
{{viewerqueue_entries_count}}Viewer queue entries count{{viewerqueue_entries_count}}42
{{viewerqueue_queue_limit}}Viewer queue max entries limit{{viewerqueue_queue_limit}}42
{{api_action_global_response}}Response retrieved from recently triggered api action (JSON strigified); use delay to await response{{api_action_global_response}}No example yet
{{last_random_input}}The last random_input that was selected so that you can use it for things like in the end tab of commands{{last_random_input}}No example yet
{{loyalty_currency_name}}The name of the loyalty currency e.g. Lumipoints{{loyalty_currency_name}}USD
{{now_playing_id}}(Now Playing) Computed unique ID for the track{{now_playing_id}}abc123
{{now_playing_title}}(Now Playing) Title of the track{{now_playing_title}}Lumiastream Stream Live
{{now_playing_artwork}}(Now Playing) Song art work{{now_playing_artwork}}https://cdn.example.com/image.png
{{now_playing_artist}}(Now Playing) Artist{{now_playing_artist}}No example yet
{{now_playing_album}}(Now Playing) Album{{now_playing_album}}No example yet
{{now_playing_label}}(Now Playing) Record label{{now_playing_label}}No example yet
{{now_playing_bpm}}(Now Playing) Original BPM of the song{{now_playing_bpm}}128
{{now_playing_rating}}(Now Playing) Rating{{now_playing_rating}}5
{{now_playing_length}}(Now Playing) Length of song in seconds{{now_playing_length}}03:45
{{now_playing_comment}}(Now Playing) Comment{{now_playing_comment}}Now playing
{{now_playing_key}}(Now Playing) Key signature{{now_playing_key}}C#m
{{now_playing_url}}(Now Playing) The Beatport or Spotify URL of the song{{now_playing_url}}https://example.com
{{now_playing_spotify_url}}(Now Playing) Spotify URL{{now_playing_spotify_url}}https://open.spotify.com/track/abc123
{{now_playing_beatport_url}}(Now Playing) Beatport track URL{{now_playing_beatport_url}}https://www.beatport.com/track/example/123456
{{now_playing_beatport_id}}(Now Playing) Beatport track ID{{now_playing_beatport_id}}abc123
{{now_playing_file_path}}(Now Playing) Path to media{{now_playing_file_path}}/Users/name/Music/song.mp3
{{heartrate_bpm}}(Pulsoid/Hyperate) BPM of your heart{{heartrate_bpm}}128
{{follower_goal}}Follower goal target imported from StreamElements{{follower_goal}}lumiastream
{{subscriber_goal}}Subscriber goal target imported from StreamElements{{subscriber_goal}}lumiastream
{{cheer_goal}}Cheer/bits goal target imported from StreamElements{{cheer_goal}}No example yet
{{tip_goal}}Tip/donation goal target imported from StreamElements{{tip_goal}}No example yet
{{superchat_goal}}Superchat goal target imported from StreamElements{{superchat_goal}}No example yet
{{merch_goal_orders}}Merch order count goal imported from StreamElements{{merch_goal_orders}}No example yet
{{merch_goal_items}}Merch item count goal imported from StreamElements{{merch_goal_items}}No example yet
{{merch_goal_total}}Merch revenue goal imported from StreamElements{{merch_goal_total}}No example yet
{{session_top_tipper}}Top tipper this session (cumulative giver){{session_top_tipper}}No example yet
{{session_top_tipper_amount}}Amount donated by the session top tipper{{session_top_tipper_amount}}25.00
{{week_top_tipper}}Top tipper this week (cumulative giver){{week_top_tipper}}No example yet
{{week_top_tipper_amount}}Amount donated by the week top tipper{{week_top_tipper_amount}}25.00
{{month_top_tipper}}Top tipper this month (cumulative giver){{month_top_tipper}}No example yet
{{month_top_tipper_amount}}Amount donated by the month top tipper{{month_top_tipper_amount}}25.00
{{alltime_top_tipper}}All-time top tipper (cumulative giver){{alltime_top_tipper}}No example yet
{{alltime_top_tipper_amount}}Amount donated by the all-time top tipper{{alltime_top_tipper_amount}}25.00
{{last_charity_donator}}Latest charity-campaign donor name{{last_charity_donator}}lumiastream
{{last_charity_donation_amount}}Amount of the latest charity donation{{last_charity_donation_amount}}25.00
{{session_top_charity_donation}}Largest single charity donation this session{{session_top_charity_donation}}No example yet
{{session_top_charity_donation_amount}}Amount of the largest single session charity donation{{session_top_charity_donation_amount}}25.00
{{week_top_charity_donation}}Largest single charity donation this week{{week_top_charity_donation}}No example yet
{{week_top_charity_donation_amount}}Amount of the largest single week charity donation{{week_top_charity_donation_amount}}25.00
{{month_top_charity_donation}}Largest single charity donation this month{{month_top_charity_donation}}No example yet
{{month_top_charity_donation_amount}}Amount of the largest single month charity donation{{month_top_charity_donation_amount}}25.00
{{alltime_top_charity_donation}}Largest single charity donation all-time{{alltime_top_charity_donation}}No example yet
{{alltime_top_charity_donation_amount}}Amount of the largest single all-time charity donation{{alltime_top_charity_donation_amount}}25.00
{{session_top_charity_donator}}Top charity donor this session (cumulative giver){{session_top_charity_donator}}lumiastream
{{session_top_charity_donator_amount}}Amount donated by the session top charity donor{{session_top_charity_donator_amount}}25.00
{{week_top_charity_donator}}Top charity donor this week (cumulative giver){{week_top_charity_donator}}lumiastream
{{week_top_charity_donator_amount}}Amount donated by the week top charity donor{{week_top_charity_donator_amount}}25.00
{{month_top_charity_donator}}Top charity donor this month (cumulative giver){{month_top_charity_donator}}lumiastream
{{month_top_charity_donator_amount}}Amount donated by the month top charity donor{{month_top_charity_donator_amount}}25.00
{{alltime_top_charity_donator}}All-time top charity donor (cumulative giver){{alltime_top_charity_donator}}lumiastream
{{alltime_top_charity_donator_amount}}Amount donated by the all-time top charity donor{{alltime_top_charity_donator_amount}}25.00
{{week_top_cheer}}Largest single cheer this week{{week_top_cheer}}No example yet
{{week_top_cheer_amount}}Bit amount for the largest single week cheer{{week_top_cheer_amount}}25.00
{{month_top_cheer}}Largest single cheer this month{{month_top_cheer}}No example yet
{{month_top_cheer_amount}}Bit amount for the largest single month cheer{{month_top_cheer_amount}}25.00
{{alltime_top_cheer}}Largest single cheer all-time{{alltime_top_cheer}}No example yet
{{alltime_top_cheer_amount}}Bit amount for the largest single all-time cheer{{alltime_top_cheer_amount}}25.00
{{recent_followers}}Comma-separated list of recent followers{{recent_followers}}lumiastream
{{recent_subscribers}}Comma-separated list of recent subscribers{{recent_subscribers}}lumiastream,rgblumia
{{recent_hosts}}Comma-separated list of recent hosts{{recent_hosts}}No example yet
{{recent_raiders}}Comma-separated list of recent raiders{{recent_raiders}}lumiastream
{{recent_raiders_amount}}Parallel comma-separated viewer counts for recent raiders{{recent_raiders_amount}}25.00
{{recent_cheers}}Comma-separated list of recent cheerers{{recent_cheers}}No example yet
{{recent_cheers_amount}}Parallel comma-separated bit amounts for recent cheerers{{recent_cheers_amount}}25.00
{{recent_tips}}Comma-separated list of recent tippers{{recent_tips}}No example yet
{{recent_tips_amount}}Parallel comma-separated tip amounts for recent tippers{{recent_tips_amount}}25.00
{{recent_superchats}}Comma-separated list of recent superchatters{{recent_superchats}}No example yet
{{recent_superchats_amount}}Parallel comma-separated superchat amounts for recent superchatters{{recent_superchats_amount}}25.00
{{recent_charity_donations}}Comma-separated list of recent charity donors{{recent_charity_donations}}No example yet
{{recent_charity_donations_amount}}Parallel comma-separated donation amounts for recent charity donors{{recent_charity_donations_amount}}25.00
Chat and commands

Use these when building chat responses, command replies, redeems, or chatbot actions.

Chatbot command (22)
VariableMeaningUse it like
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Chat match (5)
VariableMeaningUse it like
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{language_detect_result}}The language detection result will display either the default message or the translated message, depending on the action selected from the 'Action to Do' dropdown menu{{language_detect_result}}
{{detected_language}}The language of the written chat message, such as English, Spanish, etc.{{detected_language}}
{{detected_language_code}}The language code of the written chat message, such as en, es, etc.{{detected_language_code}}
Chat command (24)
VariableMeaningUse it like
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
{{points_cost}}Loyalty Points command cost{{points_cost}}
{{voice_command_full_sentence}}The full sentence that was picked up when a voice command has been triggered{{voice_command_full_sentence}}
Kick points (16)
VariableMeaningUse it like
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{prompt}}The users message that was prompted{{prompt}}
{{message}}The message text sent by the user{{message}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{points}}(Twitch) How many points were used for a Twitch Point redemption{{points}}
{{title}}The title of the Twitch Redemption that was redeemed{{title}}
{{timestamp}}The time the command was triggered{{timestamp}}
Twitch extension redeem (16)
VariableMeaningUse it like
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{prompt}}The users message that was prompted{{prompt}}
{{message}}The message text sent by the user{{message}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{bits}}(Twitch) How many bits were used with the Twitch Extension redemption{{bits}}
{{timestamp}}The time the command was triggered{{timestamp}}
{{points_cost}}Loyalty Points command cost{{points_cost}}
Twitch channel points (16)
VariableMeaningUse it like
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{prompt}}The users message that was prompted{{prompt}}
{{message}}The message text sent by the user{{message}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{points}}(Twitch) How many points were used for a Twitch Point redemption{{points}}
{{title}}The title of the Twitch Redemption that was redeemed{{title}}
{{timestamp}}The time the command was triggered{{timestamp}}
Aichat (19)
VariableMeaningUse it like
{{ai_response}}No description available yet.{{ai_response}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Commands (24)
VariableMeaningUse it like
{{get_all_commands}}Get all commands and chatbot commands that are on e.g. {{get_all_commands}}{{get_all_commands}}
{{get_commands}}Get all commands and chatbot commands that the user who triggered the command can use, e.g. {{get_commands}}{{get_commands}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{originType}}No description available yet.{{originType}}
{{queueType}}No description available yet.{{queueType}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{messageWithoutEmotes}}The message that the sender sent without the command/alias and without emots inside of the message. Mainly used for TTS.{{messageWithoutEmotes}}
{{rawMessageWithoutEmotes}}The raw message that the sender sent without emotes inside of the message{{rawMessageWithoutEmotes}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Cooldowns (1)
VariableMeaningUse it like
{{cooldown_time_remaining}}The time remaining for a cooldown in seconds{{cooldown_time_remaining}}
Duel (24)
VariableMeaningUse it like
{{duel_result}}The Duel result will display a winning, losing, or invalid input message based on the game status{{duel_result}}
{{duel_winner}}The username of the duel winner{{duel_winner}}
{{duel_loser}}The username of the duel loser{{duel_loser}}
{{duel_target_username}}Target is the one who was been challenged for a duel{{duel_target_username}}
{{duel_duration}}Duel duration{{duel_duration}}
{{outcome_amount}}The outcome amount is the total won or lost during a game.{{outcome_amount}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
File Watcher (4)
VariableMeaningUse it like
{{content}}Content of the watched file{{content}}
{{file}}Path of the watched file{{file}}
{{path}}Path of the watched file{{path}}
{{timestamp}}The time the command was triggered{{timestamp}}
Followage (19)
VariableMeaningUse it like
{{follow_time}}No description available yet.{{follow_time}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Loyalty Points (23)
VariableMeaningUse it like
{{points_balance}}Loyalty Points balance for this user. Can only be used in the !points chatbot command{{points_balance}}
{{user_rank}}The user's position in the loyalty points ranking list. For example, rank 4 means the user is in the 4th position in the loyalty points list.{{user_rank}}
{{total_rank}}The total number of users in the loyalty points list. For example, 125 users. This can be used with the {{user_rank}} variable. For example, the username's rank is 3 out of a total of 125 users.{{total_rank}}
{{loyalty_currency_name}}The name of the loyalty currency e.g. Lumipoints{{loyalty_currency_name}}
{{get_user_loyalty_points}}Get the loyalty points value of a user. e.g. variable will be: {{get_user_loyalty_points={{message}}}}, or viewer's username and platform {{get_user_loyalty_points={{username}},{{platform}}}}. Then use it like this: !command username or !command username,platform. Result will be the point ballance without currency{{get_user_loyalty_points}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Raffle Entry (28)
VariableMeaningUse it like
{{raffle_title}}Title of the raffle{{raffle_title}}
{{raffle_description}}Description of the raffle{{raffle_description}}
{{raffle_entries}}Raffle entries list separated by comma e.g user1,user2,user3{{raffle_entries}}
{{raffle_generated_number}}The number that has been selected for the raffle{{raffle_generated_number}}
{{raffle_entries_count}}Raffle entries count{{raffle_entries_count}}
{{raffle_winners}}All of the usernames of users who won the raffle (Comma separated){{raffle_winners}}
{{raffle_type}}Type of raffle{{raffle_type}}
{{raffle_winner}}Username of user who won the raffle{{raffle_winner}}
{{raffle_winner_avatar}}Avatar of user who won the raffle{{raffle_winner_avatar}}
{{raffle_entry_command}}Command that enters a user into the raffle{{raffle_entry_command}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Roulette (21)
VariableMeaningUse it like
{{roulette_result}}The roulette result will display a winning, losing, or invalid input message based on the game status{{roulette_result}}
{{ball_position}}The position where the ball lands in a game.{{ball_position}}
{{outcome_amount}}The outcome amount is the total won or lost during a game.{{outcome_amount}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Shoutout (43)
VariableMeaningUse it like
{{clip_shoutout_url}}shoutout_video_url{{clip_shoutout_url}}
{{clip_title}}Clip's title{{clip_title}}
{{clip_url}}clip_url{{clip_url}}
{{clip_target_username}}Target user's username from the clip{{clip_target_username}}
{{clip_target_userid}}Target user's ID from the clip{{clip_target_userid}}
{{clip_target_avatar}}Target user's avatar from the clip{{clip_target_avatar}}
{{clip_thumbnail_url}}Clip's thumbnail URL{{clip_thumbnail_url}}
{{clip_duration}}Clip's duration{{clip_duration}}
{{clip_target_channel}}Target user's channel link{{clip_target_channel}}
{{clip_embed_url}}Clip's embed URL{{clip_embed_url}}
{{clip_id}}ID of the clip{{clip_id}}
{{clip_creator_id}}Clip creators ID from the clip{{clip_creator_id}}
{{clip_creator_name}}Clip creators name from the clip{{clip_creator_name}}
{{clip_game_id}}Clip's game ID{{clip_game_id}}
{{clip_language}}Clip's language{{clip_language}}
{{clip_view_count}}Clip's view count{{clip_view_count}}
{{clip_created_at}}Date clip was created{{clip_created_at}}
{{clip_target_displayname}}Target's display name{{clip_target_displayname}}
{{clip_target_language}}Target's language{{clip_target_language}}
{{clip_target_category_id}}Target's category id{{clip_target_category_id}}
{{clip_target_category}}Target's category{{clip_target_category}}
{{current_target_category_id}}No description available yet.{{current_target_category_id}}
{{current_target_category}}No description available yet.{{current_target_category}}
{{clip_target_channel_title}}Target's current or last stream title{{clip_target_channel_title}}
{{clip_target_channel_tags}}Target's current or last stream tags{{clip_target_channel_tags}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Slots (21)
VariableMeaningUse it like
{{slots_result}}The slots result will display a winning, losing, or invalid input message based on the game status{{slots_result}}
{{slots_combo}}The slots roll combination e.g. ⭐️ ⭐️ ⭐️ or 🍒 🍒 🍒{{slots_combo}}
{{outcome_amount}}The outcome amount is the total won or lost during a game.{{outcome_amount}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Uptime (19)
VariableMeaningUse it like
{{uptime}}The time your stream has been started for: {{uptime}}{{uptime}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Viewer Queue Entry (24)
VariableMeaningUse it like
{{viewerqueue_title}}Viewer queue title{{viewerqueue_title}}
{{viewerqueue_entry_command}}Viewer queue entry command e.g: !joinq{{viewerqueue_entry_command}}
{{viewerqueue_entries}}Viewer queue entries list separated by comma e.g viewer1,viewer2,viewer3{{viewerqueue_entries}}
{{viewerqueue_players}}Viewer queue selected players list separated by comma e.g player1,player2,player3{{viewerqueue_players}}
{{viewerqueue_entries_count}}Viewer queue entries count{{viewerqueue_entries_count}}
{{viewerqueue_queue_limit}}Viewer queue max entries limit{{viewerqueue_queue_limit}}
{{username}}The username of the sender{{username}}
{{displayname}}The display name of the sender{{displayname}}
{{userId}}The user ID of the sender{{userId}}
{{avatar}}The url of the avatar of the sender for a message{{avatar}}
{{userLevels}}The user levels of the sender for a message. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevels.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevels}}
{{userLevelsRaw}}The raw user levels of the sender for a message in object format. Contains: broadcaster, moderator, vip, tier3, tier2, subscriber, regular, follower, anyone. Example: {{userLevelsRaw.subscriber}} to check if the user is a subscriber. Returns true or false{{userLevelsRaw}}
{{channelDescription}}The description of the target channel{{channelDescription}}
{{channelViews}}Amount of views the target channel has{{channelViews}}
{{command}}The command that was triggered for the message{{command}}
{{message}}The message text sent by the user{{message}}
{{messageId}}The ID of the message{{messageId}}
{{userColor}}(Twitch) The hex color of the sender for a Twitch message, e.g. #FF00FF{{userColor}}
{{platform}}The streaming platform this message is coming from{{platform}}
{{badgesRaw}}The raw badges for the message{{badgesRaw}}
{{hasEmotes}}Whether or not a message contains an emote{{hasEmotes}}
{{emotes}}emotes that were sent inside of a message. It will look like: ID:Name,ID:Name{{emotes}}
{{emotesRaw}}The raw emotes that were used for a message{{emotesRaw}}
{{timestamp}}The time the command was triggered{{timestamp}}
Alerts and events

Search an alert and inspect a live example of what Overlay.on('alert') receives. Template alert variables map to the same keys inside data.extraSettings. For the full alert event type, see Overlay Type Definitions.

Live preview

Alert: lumiastream-donation

Message template: {{username}} just tipped {{currencySymbol}}{{amount}}. They said {{message}}

Overlay payload explorer
data {4}
alert: "lumiastream-donation"
extraSettings {7}
username: "lumiastream"
amount: 100
currency: "USD"
message: "Great Stream"
sender_social_link: "https://twitch.tv/lumiastream"
avatar: "https://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png"
anonymous: false
fromLumia: true
dynamic {2}
value: 100
currency: "USD"
Template variableOverlay pathMeaningExample values
{{username}}data.extraSettings.usernameThe username of the senderlumiastream
{{avatar}}data.extraSettings.avatarThe url of the avatar of the sender for a messagehttps://static-cdn.jtvnw.net/jtv_user_pictures/2b1fa336-f9b2-42cf-bd2c-98675da74982-profile_image-70x70.png
{{sender_social_link}}data.extraSettings.sender_social_linkNo description available yet.https://twitch.tv/lumiastream
{{currency}}data.extraSettings.currencyThe currency usedUSD
{{currencySymbol}}data.extraSettings.currencySymbolThe currency symbol usedNo example yet
{{amount}}data.extraSettings.amountThe amount sent100200300
{{message}}data.extraSettings.messageThe message text sent by the userGreat Stream
{{anonymous}}data.extraSettings.anonymousNo description available yet.false
{{command}}data.extraSettings.commandThe command that was triggered for the messageNo example yet