Skip to reference

Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

When · Where · Do

Automation Reference

The exact behavior of actions, triggers, commands, variables and SheevPad navigation. Share an entry with your AI assistant to build a command using supported controls.

2.8.0 · 441 entries · 79 actions · 29 triggers · 59 global variables

Download JSONDownload Markdown

Build instructions from a goal

Start with the editor setup, then combine trigger and action contracts. Instructions include initial names, categories, enabled state, field selections, action order and saving.

Using this reference with an AI assistant

For a specific answer, share an entry link. The complete downloads include every record and may be larger than your assistant’s context window.

Provider filtering finds mentions and prerequisites. Check each entry’s contract for actual support.

441 entries

Do · Actions gated

Refresh Conversation Starters

Check for newly prepared questions and download only a changed package.

action.conversation_topic_refresh

automation · timer · command · pad

Do · Actions gated

Select Next Conversation Starter

Select one unused prepared question, or reuse the current active question.

action.conversation_topic_next

automation · timer · command · pad

Do · Actions gated

Send Current Conversation Starter

Send the current question, mark it used after a successful delivery, and advance to the next one.

action.conversation_topic_send

automation · timer · command · pad

Do · Actions gated

Mark Conversation Starter Used

Mark the current question used and advance to the next one.

action.conversation_topic_mark_used

automation · timer · command · pad

Do · Actions gated

Release Conversation Starter

Return the current question to the unused queue without marking it used.

action.conversation_topic_release

automation · timer · command · pad

Do · Actions gated

Set Bot Voice

Activate a saved voice or create a custom one from action text and command variables. Response Rules still apply.

action.ai_personality_set

automation · timer · command · pad

Do · Actions gated

Generate raid greeting

Generate and send a short greeting using only the incoming raider identity, optional bio, latest title/category, and active Bot Voice.

action.ai_generated_raid_shoutout

automation · command · pad

Do · Actions gated

Generate creator introduction

Generate and send a voice-aware introduction using the creator's available profile, latest title, and category.

action.ai_generated_shoutout

automation · timer · command · pad

Do · Actions gated

Generate viewer greeting

Generate a short voice-aware greeting for a first-time chatter, returning viewer, or follower on the triggering platform.

action.ai_generated_welcome

automation · command · pad

Do · Actions gated

Generate community reaction

Celebrate the triggering support or community event in chat, an Overlay Builder alert, or both.

action.ai_generated_event_celebration

automation · command · pad

Do · Actions gated

Generate stream opening message

Open the show with a fresh message in the active Bot Voice. Optional guidance can name the planned segment or mood.

action.ai_stream_showstarter

automation · timer · command · pad

Do · Actions gated

Generate after-ad message

After the triggering ad finishes, welcome chat back with a fresh message in the active Bot Voice.

action.ai_stream_ad_followup

automation · command · pad

Do · Actions gated

Generate recent chat summary

Summarize recent meaningful viewer conversation without quoting private or filtered chat.

action.ai_stream_chat_recap

automation · timer · command · pad

Do · Actions gated

Generate scheduled message variations

The first run writes and stores 10 Bot Voice variations of this announcement. Each later run sends the next unused message; after all 10 are used, the following run prepares a new set.

action.ai_smart_timer_announcement

timer · command · pad

Do · Actions gated

Generate with Writing Assistant

Transform source text with a selected writing tool, then send the result to the chosen chat.

action.ai_creative_utility

automation · timer · command · pad

Do · Actions supported

Pause / wait

Wait before continuing to the next action in this sequence.

action.pause

automation · timer · command · pad

Do · Actions supported

Send chat message

Send a message to the event/timer platform. Automations may target all platforms; timers still obey their platform and online-only rules.

action.chat

automation · timer · command · pad

Do · Actions supported

Send announcement

Send a native Twitch announcement when possible. Other platforms fall back to a normal announcement-style chat message.

action.announcement

automation · timer · command · pad

Do · Actions supported

Send chat message (delayed)

Send a message after a delay. Useful for countdowns before ad breaks.

action.chat_delay

automation · timer · command · pad

Do · Actions supported

Shoutout

Send a native Twitch shoutout for the triggering user. Requires an event with a {user}.

action.shoutout

automation · command · pad

Do · Actions supported

Song request

Add a song or search query to the song request queue. This works even if the public !sr chat command is disabled.

action.song_request

automation · timer · command · pad

Do · Actions supported

Current song

Post the currently playing song.

action.song_now_playing

automation · timer · command · pad

Do · Actions supported

Show song queue

Post the current song request queue.

action.song_queue

automation · timer · command · pad

Do · Actions supported

Skip song

Skip the current song request.

action.song_skip

automation · timer · command · pad

Do · Actions supported

Pause song

Pause song request playback.

action.song_pause

automation · timer · command · pad

Do · Actions supported

Resume song

Resume song request playback.

action.song_resume

automation · timer · command · pad

Do · Actions supported

Give bonus loyalty

Award bonus loyalty currency to a viewer. Blank username uses the triggering viewer when available.

action.bonus_points

automation · timer · command · pad

Do · Actions supported

Set loyalty name

Change the loyalty currency name everywhere in SheevChat without changing viewer balances or other loyalty settings.

action.set_loyalty_point_name

automation · timer · command · pad

Do · Actions supported

Set Windows playback device

Change the Windows default playback endpoint. Console + Multimedia covers normal app audio; Communications is separate for calling apps.

action.windows_set_default_playback

automation · timer · command · pad

Do · Actions supported

Set Windows input device

Change the Windows default microphone or capture endpoint. Console + Multimedia covers normal app input; Communications is separate for calling apps.

action.windows_set_default_input

automation · timer · command · pad

Do · Actions supported

Set Windows system volume

Set the master volume on the current default Multimedia playback device.

action.windows_set_system_volume

automation · timer · command · pad

Do · Actions supported

Set Windows system mute

Mute, unmute, or toggle the current default Multimedia playback device.

action.windows_set_system_mute

automation · timer · command · pad

Do · Actions supported

Snooze upcoming Twitch ad

Use one available Twitch ad snooze. In an Incoming raid Automation, optionally skip this action unless the next ad falls within a chosen window.

action.twitch_snooze_upcoming_ad

automation · timer · command · pad

Do · Actions supported

Show top loyalty

Post the loyalty leaderboard.

action.top_points

automation · timer · command · pad

Do · Actions supported

Post random quote

Post a random saved quote, or search if filter text is provided.

action.random_quote

automation · timer · command · pad

Do · Actions supported

Add quote

Save a quote to the quote database.

action.add_quote

automation · timer · command · pad

Do · Actions supported

Increment counter

Add to a named counter. Amount defaults to 1.

action.increment_counter

automation · timer · command · pad

Do · Actions supported

Set counter

Set a named counter to a specific value.

action.set_counter

automation · timer · command · pad

Do · Actions supported

Reset counter

Reset a named counter back to zero.

action.reset_counter

automation · timer · command · pad

Do · Actions supported

Increment user counter

Add to one viewer inside a user counter category. Blank username uses the triggering viewer.

action.increment_user_counter

automation · timer · command · pad

Do · Actions supported

Set user counter

Set one viewer value inside a user counter category.

action.set_user_counter

automation · timer · command · pad

Do · Actions supported

Reset user counter

Reset one viewer value inside a user counter category.

action.reset_user_counter

automation · timer · command · pad

Do · Actions supported

Show watchtime

Post watchtime for a viewer. Blank username uses the triggering viewer when available.

action.watchtime_lookup

automation · timer · command · pad

Do · Actions supported

Stop trivia

Stop the one active unified trivia game on every participating platform.

action.stop_trivia

automation · timer · command · pad

Do · Actions supported

Set stream title

Update the stream title on selected platforms. Supports command variables.

action.set_stream_title

automation · timer · command · pad

Do · Actions supported

Set stream category

Update the category/game on selected platforms. YouTube also accepts a numeric category ID.

action.set_stream_category

automation · timer · command · pad

Do · Actions supported

Chat Overlay

Apply a saved Chat Overlay theme preset. Future overlay theme packs will use this same picker.

action.change_theme

automation · timer · command · pad

Do · Actions supported

Master Overlay

Switch the dynamic Master Overlay source to an existing Overlay Builder overlay.

action.change_master_overlay

automation · timer · command · pad

Do · Actions supported

UI Resizing

Adjust SheevChat UI font-size sliders from commands, automations, timers, or SheevPad.

action.ui_resizing

automation · timer · command · pad

Do · Actions supported

Trigger Alert

Send an alert payload to Overlay Builder Alert Box widgets. Event variables from raids, subs, follows, cheers, and custom triggers can be used in the text fields.

action.trigger_alert

automation · timer · command · pad

Do · Actions supported

Trigger Marketplace Widget

Send a button/action event to a Marketplace Item widget in Overlay Builder.

action.trigger_marketplace_widget

automation · timer · command · pad

Do · Actions supported

Send TTS/Text Payload

Speak text through every running Overlay Builder browser source. This does not play desktop TTS audio.

action.send_overlay_tts

automation · timer · command · pad

Do · Actions supported

Play Audio Payload

Play a Media Library audio item through every running Overlay Builder browser source. This does not play desktop audio.

action.send_overlay_audio

automation · timer · command · pad

Do · Actions supported

Send Text Payload

Send a generic text payload to overlay widgets. Useful for custom widgets that display queue, prompt, or status text.

action.send_overlay_text

automation · timer · command · pad

Do · Actions supported

Create Twitch Clip

Create a clip from the connected Twitch broadcaster stream. Twitch supports requested lengths from 5 to 60 seconds.

action.create_twitch_clip

automation · timer · command · pad

Do · Actions supported

Queue Clip

Queue a supported short-form clip URL for the Clip Overlay. Supports variables, so channel point messages can be passed in.

action.queue_clip

automation · timer · command · pad

Do · Actions legacy

Queue Clip

Legacy action name. Queue a supported clip URL for the Clip Overlay.

action.queue_tiktok_clip

Hidden from new action selection

Do · Actions supported

Skip Current Clip

Skip the active Clip Overlay video and continue to the next ready clip.

action.skip_current_clip

automation · timer · command · pad

Do · Actions supported

Clear Clip Queue

Clear pending clip downloads, ready clips, and the active Clip Overlay playback.

action.clear_clip_queue

automation · timer · command · pad

Do · Actions supported

Set Clip Command Enabled

Enable or disable the !playclip chat command.

action.set_clip_command_enabled

automation · timer · command · pad

Do · Actions supported

Toggle Clip Command Enabled

Toggle the !playclip chat command on or off.

action.toggle_clip_command_enabled

automation · timer · command · pad

Do · Actions legacy

Clear Clip Queue

Legacy action name. Clear pending clip downloads, ready clips, and active Clip Overlay playback.

action.clear_tiktok_queue

Hidden from new action selection

Do · Actions supported

OBS Studio Control

Run an OBS Studio WebSocket action. Uses the OBS settings from Settings > Connect.

action.obs_control

automation · timer · command · pad

Do · Actions supported

Streamlabs Desktop Control

Run a Streamlabs Desktop local API action. Uses the Streamlabs Desktop settings from Settings > Connect.

action.streamlabs_control

automation · timer · command · pad

Do · Actions supported

Roll Credits

Start the Credits overlay scroll for the current stream credits session.

action.roll_credits

automation · timer · command · pad

Do · Actions supported

Clear Credits Session

Clear the current stream credits session and save a restore point for Undo Clear.

action.clear_credits_session

automation · timer · command · pad

Do · Actions supported

Undo Clear Credits Session

Restore the most recently cleared current stream credits session.

action.undo_clear_credits_session

automation · timer · command · pad

Do · Actions supported

Send keystrokes

Send a Windows keyboard macro to the active app. Use ^ for Ctrl, + for Shift, % for Alt. Supports {ENTER}, {TAB}, and {WAIT 500} on separate lines.

action.send_keystrokes

automation · timer · command · pad

Do · Actions supported

Launch application

Open a local app or file on the SheevChat PC. Optional arguments are split like a normal command line.

action.launch_application

automation · timer · command · pad

Do · Actions supported

Launch Steam Game

Launch an installed Steam game on the SheevChat PC using its Steam AppID.

action.launch_steam_game

automation · timer · command · pad

Do · Actions supported

Launch Epic Game

Launch an installed Epic Games title using Epic Games Launcher. Direct title launch is experimental until verified per machine.

action.launch_epic_game

automation · timer · command · pad

Do · Actions supported

Launch Ubisoft Game

Launch an installed Ubisoft Connect game using a verified local Ubisoft game ID.

action.launch_ubisoft_game

automation · timer · command · pad

Do · Actions supported

Launch EA Game

Launch an installed EA game directly when an executable is available, otherwise open the EA app.

action.launch_ea_game

automation · timer · command · pad

Do · Actions supported

Launch Battle.net Game

Launch an installed Battle.net game through the Battle.net desktop app.

action.launch_battlenet_game

automation · timer · command · pad

Do · Actions supported

Advanced: run command text

Advanced fallback for power users. Prefer the friendly bot actions above when possible.

action.run_command

automation · timer · command · pad

Do · Actions supported

Start trivia

Start one shared trivia game across the base target and any additional selected platforms.

action.trivia

automation · timer · command · pad

Do · Actions unavailable

AI prompt (coming soon)

Send the event context to an AI and use the response in chat.

action.ai_prompt

Hidden from new action selection

Do · Actions supported

Fetch webhook

Send an HTTP request to a URL. Useful for triggering external services, n8n/Zapier webhooks, or home automation. Variable substitution supported in URL and body.

action.fetch_webhook

automation · timer · command · pad

Do · Actions supported

Run Streamer.bot Action

Runs a Streamer.bot action through a local WebSocket connection. Used by Streamer.bot command migration.

action.streamerbot_action

automation · timer · command · pad

When · Triggers supported

First chat ever

Fires the very first time a viewer sends a chat message on any platform.

trigger.first_chat

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.first_chat.user

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.first_chat.platform

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.first_chat.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.first_chat.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.first_chat.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.first_chat.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.first_chat.roomId

automation

When · Triggers supported

First chat this stream (Welcome Back)

Fires the first time a viewer sends a message this stream session — the same event that shows the Welcome Back badge. Optionally filter to specific usernames.

trigger.viewer_join

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.viewer_join.user

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.viewer_join.platform

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.viewer_join.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.viewer_join.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.viewer_join.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.viewer_join.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.viewer_join.roomId

automation

When · Triggers supported

First message this stream

Fires on a viewer’s first message of the stream, including their first-ever message. Optionally filter to specific usernames.

trigger.viewer_first_message

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.viewer_first_message.user

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.viewer_first_message.platform

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.viewer_first_message.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.viewer_first_message.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.viewer_first_message.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.viewer_first_message.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.viewer_first_message.roomId

automation

When · Triggers supported

First chat of the day

Fires on a viewer's first chat message of the calendar day (resets at midnight). Good for daily greetings or announcing daily loyalty bonuses.

trigger.first_chat_today

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.first_chat_today.user

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.first_chat_today.platform

automation

When · Triggers supported

Viewer birthday

Fires once per stream session when a viewer with a saved birthday chats on their birthday.

trigger.is_birthday

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.is_birthday.user

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.is_birthday.platform

automation

Variables supported

{birthday}

Saved formatted birthday.

variable.trigger.is_birthday.birthday

automation

Variables supported

{birthdayAge}

Birthday age when a birth year is known; otherwise empty.

variable.trigger.is_birthday.birthdayAge

automation

Variables supported

{age}

Birthday age, with birthdayAge fallback.

variable.trigger.is_birthday.age

automation

Variables supported

{agemessage}

Optional birthday age message; empty when unavailable.

variable.trigger.is_birthday.agemessage

automation

When · Triggers supported

New follow

Fires when a viewer follows on Twitch, Kick, or TikTok. YouTube does not expose a live follow event.

trigger.follow

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.follow.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.follow.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.follow.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.follow.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.follow.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.follow.roomId

automation

When · Triggers supported

Subscription

Fires on a new subscription or resub.

trigger.subscribe

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.subscribe.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.subscribe.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.subscribe.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.subscribe.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.subscribe.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.subscribe.roomId

automation

Variables supported

{months}

Subscription month count; missing value defaults to 1.

variable.trigger.subscribe.months

automation

Variables supported

{tier}

Provider subscription tier; missing value defaults to 1000.

variable.trigger.subscribe.tier

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.subscribe.message

automation

Variables supported

{count}

Subscription/gift count from the event; extraction defaults to 1.

variable.trigger.subscribe.count

automation

Variables supported

{subscriptionKind}

TikTok subscription subtype, empty when absent.

variable.trigger.subscribe.subscriptionKind

automation

When · Triggers supported

TikTok gift

Fires once when a TikTok gift or gift streak is finalized.

trigger.tiktok_gift

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.tiktok_gift.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.tiktok_gift.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.tiktok_gift.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.tiktok_gift.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.tiktok_gift.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.tiktok_gift.roomId

automation

Variables supported

{gift}

TikTok gift name.

variable.trigger.tiktok_gift.gift

automation

Variables supported

{giftId}

TikTok gift identifier.

variable.trigger.tiktok_gift.giftId

automation

Variables supported

{count}

Subscription/gift count from the event; extraction defaults to 1.

variable.trigger.tiktok_gift.count

automation

Variables supported

{diamonds}

Finalized gift diamond count, or 0.

variable.trigger.tiktok_gift.diamonds

automation

Variables supported

{amount}

Provider-normalized gift amount or Super Chat amount; do not assume cross-provider currency equivalence.

variable.trigger.tiktok_gift.amount

automation

When · Triggers supported

TikTok share

Fires when a viewer shares the TikTok LIVE.

trigger.tiktok_share

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.tiktok_share.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.tiktok_share.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.tiktok_share.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.tiktok_share.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.tiktok_share.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.tiktok_share.roomId

automation

Variables supported

{shareCount}

TikTok share counter supplied by event, or 0.

variable.trigger.tiktok_share.shareCount

automation

When · Triggers supported

TikTok likes

Fires for a TikTok like batch.

trigger.tiktok_like

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.tiktok_like.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.tiktok_like.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.tiktok_like.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.tiktok_like.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.tiktok_like.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.tiktok_like.roomId

automation

Variables supported

{likes}

Likes in the current TikTok batch, or 0.

variable.trigger.tiktok_like.likes

automation

Variables supported

{totalLikes}

TikTok stream total likes, or 0.

variable.trigger.tiktok_like.totalLikes

automation

When · Triggers supported

TikTok question

Fires when TikTok emits a viewer question.

trigger.tiktok_question

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.tiktok_question.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.tiktok_question.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.tiktok_question.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.tiktok_question.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.tiktok_question.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.tiktok_question.roomId

automation

Variables supported

{question}

TikTok viewer question text.

variable.trigger.tiktok_question.question

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.tiktok_question.message

automation

When · Triggers supported

Gift subscription

Fires when subs are gifted to the community.

trigger.gift_sub

automation

Variables supported

{gifter}

Gift subscription sender username.

variable.trigger.gift_sub.gifter

automation

Variables supported

{count}

Subscription/gift count from the event; extraction defaults to 1.

variable.trigger.gift_sub.count

automation

Variables supported

{tier}

Provider subscription tier; missing value defaults to 1000.

variable.trigger.gift_sub.tier

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.gift_sub.user

automation

When · Triggers supported

Bits / KICKs

Fires when a viewer sends Twitch bits or Kick KICKs.

trigger.cheer

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.cheer.user

automation

Variables supported

{bits}

Twitch bits or Kick KICKs amount, or 0.

variable.trigger.cheer.bits

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.cheer.message

automation

When · Triggers supported

Incoming raid

Fires when another streamer raids the channel.

trigger.raid

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.raid.user

automation

Variables supported

{target}

Raider username for incoming raids; destination login for outgoing raids.

variable.trigger.raid.target

automation

Variables supported

{target.url}

Profile URL for the target username on the current platform

variable.trigger.raid.target.url

automation

Variables supported

{target.game}

Target channel category/game on the current platform

variable.trigger.raid.target.game

automation

Variables supported

{target.title}

Target channel title on the current platform

variable.trigger.raid.target.title

automation

Variables supported

{viewers}

Incoming raid size or outgoing raid viewer count, or 0.

variable.trigger.raid.viewers

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.raid.username

automation

Variables supported

{displayName}

Event display name with username fallback.

variable.trigger.raid.displayName

automation

Variables supported

{userId}

Provider user ID when supplied; otherwise empty.

variable.trigger.raid.userId

automation

Variables supported

{eventId}

Event/message identity when supplied; otherwise empty.

variable.trigger.raid.eventId

automation

Variables supported

{roomId}

Provider room identifier when supplied; otherwise empty.

variable.trigger.raid.roomId

automation

When · Triggers supported

Raid started

Fires once when the broadcaster successfully starts an outgoing raid through SheevChat.

trigger.raid_started

automation

Variables supported

{target}

Raider username for incoming raids; destination login for outgoing raids.

variable.trigger.raid_started.target

automation

Variables supported

{targetDisplayName}

Outgoing raid destination display name with login fallback.

variable.trigger.raid_started.targetDisplayName

automation

Variables supported

{targetId}

Outgoing raid destination provider ID.

variable.trigger.raid_started.targetId

automation

Variables supported

{viewers}

Incoming raid size or outgoing raid viewer count, or 0.

variable.trigger.raid_started.viewers

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.raid_started.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.raid_started.username

automation

When · Triggers supported

Channel reward redemption

Fires when a viewer redeems a Twitch channel point reward or Kick channel reward.

trigger.channel_point_redeem

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.channel_point_redeem.user

automation

Variables supported

{user.points}

Command sender current loyalty currency

variable.trigger.channel_point_redeem.user.points

automation

Variables supported

{user.pointsRank}

Command sender loyalty rank

variable.trigger.channel_point_redeem.user.pointsRank

automation

Variables supported

{reward}

Redeemed reward name.

variable.trigger.channel_point_redeem.reward

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.channel_point_redeem.message

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.channel_point_redeem.username

automation

Variables supported

{input}

Reward redemption viewer input; mirrors message in action context.

variable.trigger.channel_point_redeem.input

automation

When · Triggers supported

Imported app event

Fires when an installed action library event stream receives a matching mapped event. Choose a specific library and event stream for normal use.

trigger.imported_app_event

automation

Variables supported

{app}

Installed event library name with ID fallback.

variable.trigger.imported_app_event.app

automation

Variables supported

{library}

Installed event library name with ID fallback.

variable.trigger.imported_app_event.library

automation

Variables supported

{libraryId}

Installed library ID.

variable.trigger.imported_app_event.libraryId

automation

Variables supported

{eventStream}

Subscription label with ID fallback.

variable.trigger.imported_app_event.eventStream

automation

Variables supported

{eventStreamId}

Subscription ID.

variable.trigger.imported_app_event.eventStreamId

automation

Variables supported

{eventText}

Mapped imported event text.

variable.trigger.imported_app_event.eventText

automation

Variables supported

{eventJson}

Imported event JSON string when supplied.

variable.trigger.imported_app_event.eventJson

automation

Variables supported

{event.key}

Mapped event key when supplied.

variable.trigger.imported_app_event.event.key

automation

Variables supported

{event.value}

Mapped event value when supplied.

variable.trigger.imported_app_event.event.value

automation

When · Triggers supported

Ad break

Fires when an ad break starts, with an optional time offset.

trigger.ad_break

automation

Variables supported

{duration}

Ad duration in seconds, or 0.

variable.trigger.ad_break.duration

automation

Variables supported

{is_automatic}

Ad type as yes/no.

variable.trigger.ad_break.is_automatic

automation

When · Triggers supported

Hype Train

Fires when a Hype Train begins.

trigger.hype_train

automation

Variables supported

{level}

Hype Train level, default 1.

variable.trigger.hype_train.level

automation

Variables supported

{goal}

Hype Train goal, default 0.

variable.trigger.hype_train.goal

automation

When · Triggers supported

Poll ended

Fires when a Twitch poll ends.

trigger.poll_end

automation

Variables supported

{title}

Poll or prediction title in these event contexts; not the channel title.

variable.trigger.poll_end.title

automation

Variables supported

{winner}

Winning poll choice.

variable.trigger.poll_end.winner

automation

Variables supported

{winner_votes}

Winning poll vote count, or 0.

variable.trigger.poll_end.winner_votes

automation

When · Triggers supported

Prediction locked

Fires when a Twitch prediction is locked for voting.

trigger.prediction_lock

automation

Variables supported

{title}

Poll or prediction title in these event contexts; not the channel title.

variable.trigger.prediction_lock.title

automation

When · Triggers supported

Super Chat / Super Sticker

Fires when a viewer sends a Super Chat or Super Sticker.

trigger.superchat

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.superchat.user

automation

Variables supported

{amount}

Provider-normalized gift amount or Super Chat amount; do not assume cross-provider currency equivalence.

variable.trigger.superchat.amount

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.superchat.message

automation

When · Triggers supported

OBS scene change

Fires when OBS changes to a selected program scene. Leave the scene blank to react to any scene change.

trigger.obs_scene_change

automation

Variables supported

{scene}

New active scene name.

variable.trigger.obs_scene_change.scene

automation

Variables supported

{previousScene}

Previous scene name.

variable.trigger.obs_scene_change.previousScene

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.obs_scene_change.platform

automation

When · Triggers supported

Streamlabs Desktop scene change

Fires when Streamlabs Desktop switches to a selected scene. Leave the scene blank to react to any scene change.

trigger.streamlabs_scene_change

automation

Variables supported

{scene}

New active scene name.

variable.trigger.streamlabs_scene_change.scene

automation

Variables supported

{previousScene}

Previous scene name.

variable.trigger.streamlabs_scene_change.previousScene

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.streamlabs_scene_change.platform

automation

When · Triggers supported

Streamlabs Desktop output status

Fires after a Streamlabs stream, recording, or replay buffer actually starts or stops. Transient statuses do not fire.

trigger.streamlabs_output_change

automation

Variables supported

{output}

Streamlabs output family: stream, record or replay.

variable.trigger.streamlabs_output_change.output

automation

Variables supported

{transition}

Settled output transition: started or stopped.

variable.trigger.streamlabs_output_change.transition

automation

Variables supported

{status}

New Streamlabs output status.

variable.trigger.streamlabs_output_change.status

automation

Variables supported

{previousStatus}

Previous output status.

variable.trigger.streamlabs_output_change.previousStatus

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.streamlabs_output_change.platform

automation

When · Triggers supported

Streamlabs Desktop scene collection change

Fires when Streamlabs Desktop switches to a selected scene collection. Leave blank for any collection.

trigger.streamlabs_collection_change

automation

Variables supported

{collection}

New Streamlabs scene collection name.

variable.trigger.streamlabs_collection_change.collection

automation

Variables supported

{previousCollection}

Previous scene collection name.

variable.trigger.streamlabs_collection_change.previousCollection

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.streamlabs_collection_change.platform

automation

When · Triggers supported

Streamlabs Desktop scene item visibility

Fires when one exact Streamlabs scene-item instance is shown or hidden. Leave the item blank for any identified item.

trigger.streamlabs_scene_item_visibility

automation

Variables supported

{scene}

New active scene name.

variable.trigger.streamlabs_scene_item_visibility.scene

automation

Variables supported

{source}

Affected Streamlabs source name.

variable.trigger.streamlabs_scene_item_visibility.source

automation

Variables supported

{visibility}

New scene-item visibility.

variable.trigger.streamlabs_scene_item_visibility.visibility

automation

Variables supported

{previousVisibility}

Previous scene-item visibility.

variable.trigger.streamlabs_scene_item_visibility.previousVisibility

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.streamlabs_scene_item_visibility.platform

automation

When · Triggers supported

Streamlabs Desktop source mute change

Fires when an identified Streamlabs source is muted or unmuted. Leave the source blank for any identified source.

trigger.streamlabs_source_mute

automation

Variables supported

{source}

Affected Streamlabs source name.

variable.trigger.streamlabs_source_mute.source

automation

Variables supported

{muteState}

New source mute state.

variable.trigger.streamlabs_source_mute.muteState

automation

Variables supported

{previousMuteState}

Previous source mute state.

variable.trigger.streamlabs_source_mute.previousMuteState

automation

Variables supported

{platform}

Originating provider, including obs/streamlabs for local events; not necessarily a chat destination.

variable.trigger.streamlabs_source_mute.platform

automation

When · Triggers supported

Chat message contains / equals

Fires when a chat message matches a keyword, pattern, or exact phrase.

trigger.chat_contains

automation

Variables supported

{user}

Viewer display name/username supplied by this event; outgoing raids use destination identity.

variable.trigger.chat_contains.user

automation

Variables supported

{username}

Normalized or provider-supplied event username, not an arbitrary command argument.

variable.trigger.chat_contains.username

automation

Variables supported

{message}

Event text; reward redemptions use viewer input, TikTok questions use the question text.

variable.trigger.chat_contains.message

automation

Variables supported

{match}

Matched literal/regex substring; equals mode uses the complete trimmed matching text.

variable.trigger.chat_contains.match

automation

Variables supported

{user}

Command sender display name

variable.global.user

automation · timer · command · pad

Variables supported

{sender.name}

Command sender normalized username

variable.global.sender.name

automation · timer · command · pad

Variables supported

{sender.id}

Platform user ID when supplied by chat

variable.global.sender.id

automation · timer · command · pad

Variables supported

{platform.userUrl}

Profile URL for the command sender on the current platform

variable.global.platform.userUrl

automation · timer · command · pad

Variables supported

{sender.points}

Command sender current loyalty currency

variable.global.sender.points

automation · timer · command · pad

Variables supported

{sender.pointsRank}

Command sender loyalty rank

variable.global.sender.pointsRank

automation · timer · command · pad

Variables supported

{target}

First argument as a username, falling back to sender

variable.global.target

automation · timer · command · pad

Variables supported

{target.name}

Target normalized username

variable.global.target.name

automation · timer · command · pad

Variables supported

{target.url}

Profile URL for the target username on the current platform

variable.global.target.url

automation · timer · command · pad

Variables supported

{target.game}

Target channel category/game on the current platform

variable.global.target.game

automation · timer · command · pad

Variables supported

{target.title}

Target channel title on the current platform

variable.global.target.title

automation · timer · command · pad

Variables supported

{target.points}

Target current loyalty currency on this platform

variable.global.target.points

automation · timer · command · pad

Variables supported

{target.pointsRank}

Target loyalty rank

variable.global.target.pointsRank

automation · timer · command · pad

Variables supported

{message}

All text entered after the command

variable.global.message

automation · timer · command · pad

Variables supported

{messageSuffix}

Optional command text wrapped for a natural reply

variable.global.messageSuffix

automation · timer · command · pad

Variables supported

{arg:1}

One command argument, numbered from 1

variable.global.arg

automation · timer · command · pad

Variables supported

{command}

Command name without its prefix

variable.global.command

automation · timer · command · pad

Variables supported

{messageId}

Triggering platform message ID when available

variable.global.messageId

automation · timer · command · pad

Variables supported

{platform}

Platform where the command was used

variable.global.platform

automation · timer · command · pad

Variables supported

{role}

Viewer highest normalized authority role

variable.global.role

automation · timer · command · pad

Variables supported

{roles}

All normalized viewer roles, comma-separated

variable.global.roles

automation · timer · command · pad

Variables supported

{authorityLevel}

Normalized numeric authority level

variable.global.authorityLevel

automation · timer · command · pad

Variables supported

{pointsName}

Configured loyalty currency name

variable.global.pointsName

automation · timer · command · pad

Variables supported

{counter:deaths}

Read a platform-specific counter, then fall back to global

variable.global.counter

automation · timer · command · pad

Variables supported

{usercounter:Check In}

Read the command sender value inside a user counter category

variable.global.usercounter

automation · timer · command · pad

Variables supported

{target.usercounter:Check In}

Read the target viewer value inside a user counter category

variable.global.target.usercounter

automation · timer · command · pad

Variables supported

{channel}

Connected channel username

variable.global.channel

automation · timer · command · pad

Variables supported

{channel.displayName}

Connected channel display name

variable.global.channel.displayName

automation · timer · command · pad

Variables supported

{channel.id}

Platform channel ID

variable.global.channel.id

automation · timer · command · pad

Variables supported

{channel.platform}

Connected platform name

variable.global.channel.platform

automation · timer · command · pad

Variables supported

{channel.isLive}

Whether the current platform is live

variable.global.channel.isLive

automation · timer · command · pad

Variables supported

{channel.chatters}

Chatters observed in the current session

variable.global.channel.chatters

automation · timer · command · pad

Variables supported

{channel.viewers}

Current viewer count when exposed by the platform

variable.global.channel.viewers

automation · timer · command · pad

Variables supported

{tiktok.viewerCount}

Current TikTok LIVE viewer count

variable.global.tiktok.viewerCount

automation · timer · command · pad

Variables supported

{tiktok.totalLikes}

Current TikTok LIVE total likes

variable.global.tiktok.totalLikes

automation · timer · command · pad

Variables supported

{tiktok.roomId}

Current TikTok LIVE room identifier

variable.global.tiktok.roomId

automation · timer · command · pad

Variables supported

{tiktok.goalProgress}

Current TikTok LIVE goal progress

variable.global.tiktok.goalProgress

automation · timer · command · pad

Variables supported

{tiktok.goalTarget}

Current TikTok LIVE goal target

variable.global.tiktok.goalTarget

automation · timer · command · pad

Variables supported

{channel.title}

Current stream title

variable.global.channel.title

automation · timer · command · pad

Variables supported

{channel.category}

Current stream category or game

variable.global.channel.category

automation · timer · command · pad

Variables supported

{channel.uptime}

Current live duration

variable.global.channel.uptime

automation · timer · command · pad

Variables supported

{sender.game}

The sender's channel category/game on the current platform

variable.global.sender.game

automation · timer · command · pad

Variables supported

{sender.stream_title}

The sender's channel title on the current platform

variable.global.sender.stream_title

automation · timer · command · pad

Variables supported

{time:America/Los_Angeles}

Current time, optionally in an IANA timezone

variable.global.time

automation · timer · command · pad

Variables supported

{date:America/Los_Angeles}

Current date, optionally in an IANA timezone

variable.global.date

automation · timer · command · pad

Variables supported

{countdown:2026-12-31 23:59}

Time remaining until a target date/time (YYYY-MM-DD or YYYY-MM-DD HH:MM)

variable.global.countdown

automation · timer · command · pad

Variables supported

{random:1:100}

Random whole number in an inclusive range

variable.global.random

automation · timer · command · pad

Variables supported

{pick:red|green|blue}

Randomly select one pipe-separated choice

variable.global.pick

automation · timer · command · pad

Variables supported

{list:prizes}

Randomly select an entry from a named Data Manager list

variable.global.list

automation · timer · command · pad

Variables supported

{viewer.random:current}

Random eligible current-session viewer; use current, all, or a platform name

variable.global.viewer.random

automation · timer · command · pad

Variables supported

{repeat:3:Hello!}

Repeat text up to ten times

variable.global.repeat

automation · timer · command · pad

Variables supported

{math:(10 + 5) * 2}

Safely evaluate basic arithmetic

variable.global.math

automation · timer · command · pad

Variables supported

{sender.watchtime}

Command sender's total watchtime

variable.global.sender.watchtime

automation · timer · command · pad

Variables supported

{target.watchtime}

Target viewer's total watchtime

variable.global.target.watchtime

automation · timer · command · pad

Variables supported

{song}

Currently playing song title

variable.global.song

automation · timer · command · pad

Variables supported

{song.artist}

Currently playing song artist

variable.global.song.artist

automation · timer · command · pad

Variables supported

{song.requester}

Who requested the current song

variable.global.song.requester

automation · timer · command · pad

Variables supported

{quote}

A random saved quote from Data Manager

variable.global.quote

automation · timer · command · pad

Variables supported

{quote.text}

Random quote text only (no attribution)

variable.global.quote.text

automation · timer · command · pad

Default commands supported

!counter

Read a named counter; automatic scope checks platform then global.

command.counter

command

Default commands supported

!count

Adjust/create a counter; moderator handling applies; missing scope is global.

command.count

command

Default commands supported

!setcounter

Set an exact counter value; moderator handling applies.

command.setcounter

command

Default commands supported

!resetcounter

Reset a counter; moderator handling applies.

command.resetcounter

command

Default commands supported

!points

Read own or target balance.

command.points

command

Default commands supported

!rank

Read own or target loyalty rank.

command.rank

command

Default commands supported

!top

Show the loyalty leaderboard.

command.top

command

Default commands supported

!give

Transfer loyalty currency.

command.give

command

Default commands supported

!bonus

Award currency; broadcaster, or moderator when allowModerators is enabled.

command.bonus

command

Default commands supported

!gamble

Bet currency using configured win chance.

command.gamble

command

Default commands supported

!duel

Challenge a viewer; acceptance expires after configured acceptSec.

command.duel

command

Default commands supported

!accept

Accept a pending duel.

command.accept

command

Default commands supported

!deny

Decline a pending duel.

command.deny

command

Default commands supported

!lurk

Mark away and send the configured social reply.

command.lurk

command

Variables supported

{user} in !lurk

Response value in the lurk command handler's own template.

variable.command.lurk.user

command

Variables supported

{messageSuffix} in !lurk

Response value in the lurk command handler's own template.

variable.command.lurk.messageSuffix

command

Default commands supported

!unlurk

Return from lurking.

command.unlurk

command

Variables supported

{user} in !unlurk

Response value in the unlurk command handler's own template.

variable.command.unlurk.user

command

Default commands supported

!vieweroptout

Exclude from random viewer selection; default scope is current platform; naming another viewer requires moderator authority.

command.vieweroptout

command

Default commands supported

!vieweroptin

Rejoin random viewer selection; default scope is current platform; naming another viewer requires moderator authority.

command.vieweroptin

command

Default commands supported

!watchtime

Show tracked total watchtime.

command.watchtime

command

Default commands supported

!cmdsearch

Search commands eligible for the current viewer/platform.

command.cmdsearch

command

Default commands supported

!sheevchat

Hidden built-in application information command.

command.sheevchat

command

Default commands supported

!settitle

Update the current platform stream title; no supported TikTok API.

command.settitle

command

Variables supported

{title} in !settitle

Response value in the settitle command handler's own template.

variable.command.settitle.title

command

Default commands supported

!setcategory

Update current platform category/game; no supported TikTok API.

command.setcategory

command

Variables supported

{game} in !setcategory

Response value in the setcategory command handler's own template.

variable.command.setcategory.game

command

Default commands supported

!setcolor

Set private SheevChat username display color.

command.setcolor

command

Default commands supported

!followage

Following duration; Twitch only.

command.followage

command

Variables supported

{user} in !followage

Response value in the followage command handler's own template.

variable.command.followage.user

command

Variables supported

{followage} in !followage

Response value in the followage command handler's own template.

variable.command.followage.followage

command

Default commands supported

!accountage

Account age; Twitch and Kick only.

command.accountage

command

Variables supported

{user} in !accountage

Response value in the accountage command handler's own template.

variable.command.accountage.user

command

Variables supported

{accountage} in !accountage

Response value in the accountage command handler's own template.

variable.command.accountage.accountage

command

Default commands supported

!birthday

Look up saved birthday/countdown.

command.birthday

command

Variables supported

{user} in !birthday

Response value in the birthday command handler's own template.

variable.command.birthday.user

command

Variables supported

{birthday} in !birthday

Response value in the birthday command handler's own template.

variable.command.birthday.birthday

command

Variables supported

{birthdaycountdown} in !birthday

Response value in the birthday command handler's own template.

variable.command.birthday.birthdaycountdown

command

Default commands supported

!setbirthday

Save birthday using configured MM-DD or DD-MM format, with optional year.

command.setbirthday

command

Variables supported

{user} in !setbirthday

Response value in the setbirthday command handler's own template.

variable.command.setbirthday.user

command

Variables supported

{birthday} in !setbirthday

Response value in the setbirthday command handler's own template.

variable.command.setbirthday.birthday

command

Default commands supported

!deletebirthday

Delete own birthday; another viewer requires moderator handling.

command.deletebirthday

command

Variables supported

{user} in !deletebirthday

Response value in the deletebirthday command handler's own template.

variable.command.deletebirthday.user

command

Default commands supported

!tarotcards

Draw Past / Present / Future tarot cards.

command.tarotcards

command

Default commands supported

!playclip

Queue supported short-form video; disabled by default, with configured limits and eligible sources.

command.playclip

command

Default commands supported

!clip

Create a Twitch clip of previous 5–60 seconds; missing length requests 60.

command.clip

command

Default commands supported

!weather

Current weather for a place or coordinates.

command.weather

command

Default commands supported

!trivia

Start shared trivia; disabled by default.

command.trivia

command

Default commands supported

!triviastop

Stop shared trivia.

command.triviastop

command

Default commands supported

!quote

Random quote or lookup.

command.quote

command

Default commands supported

!quoteadd

Save a quote.

command.quoteadd

command

Default commands supported

!quoteremove

Remove a saved quote.

command.quoteremove

command

Default commands supported

!sr

Request a song.

command.sr

command

Variables supported

{user} in !sr

Response value in the sr command handler's own template.

variable.command.sr.user

command

Variables supported

{title} in !sr

Response value in the sr command handler's own template.

variable.command.sr.title

command

Variables supported

{artist} in !sr

Response value in the sr command handler's own template.

variable.command.sr.artist

command

Default commands supported

!song

Current song.

command.song

command

Variables supported

{title} in !song

Response value in the song command handler's own template.

variable.command.song.title

command

Variables supported

{artist} in !song

Response value in the song command handler's own template.

variable.command.song.artist

command

Variables supported

{requested_by} in !song

Response value in the song command handler's own template.

variable.command.song.requested_by

command

Default commands supported

!next

Next queued song.

command.next

command

Variables supported

{title} in !next

Response value in the next command handler's own template.

variable.command.next.title

command

Variables supported

{artist} in !next

Response value in the next command handler's own template.

variable.command.next.artist

command

Default commands supported

!queue

Show queued songs.

command.queue

command

Variables supported

{queue} in !queue

Response value in the queue command handler's own template.

variable.command.queue.queue

command

Default commands supported

!wrongsong

Remove your latest request.

command.wrongsong

command

Variables supported

{user} in !wrongsong

Response value in the wrongsong command handler's own template.

variable.command.wrongsong.user

command

Variables supported

{title} in !wrongsong

Response value in the wrongsong command handler's own template.

variable.command.wrongsong.title

command

Default commands supported

!voteskip

Vote to skip current song.

command.voteskip

command

Variables supported

{user} in !voteskip

Response value in the voteskip command handler's own template.

variable.command.voteskip.user

command

Variables supported

{votes} in !voteskip

Response value in the voteskip command handler's own template.

variable.command.voteskip.votes

command

Variables supported

{threshold} in !voteskip

Response value in the voteskip command handler's own template.

variable.command.voteskip.threshold

command

Default commands supported

!songskip

Skip current song.

command.songskip

command

Variables supported

{user} in !songskip

Response value in the songskip command handler's own template.

variable.command.songskip.user

command

Default commands supported

!songpause

Pause playback.

command.songpause

command

Default commands supported

!songresume

Resume playback.

command.songresume

command

Default commands supported

!songclear

Clear queued songs.

command.songclear

command

Default commands supported

!volume

Read or set playback volume.

command.volume

command

Variables supported

{vol} in !volume

Response value in the volume command handler's own template.

variable.command.volume.vol

command

Default commands supported

!songapprove

Approve a pending request; missing ID selects the latest pending request.

command.songapprove

command

Default commands supported

!songreject

Reject a pending request; missing ID selects the latest pending request.

command.songreject

command

Default commands supported

!loadplaylist

Load a YouTube or Spotify playlist into song requests.

command.loadplaylist

command

Default commands supported

!bansong

Block the currently playing song.

command.bansong

command

Variables supported

{title} in !bansong

Response value in the bansong command handler's own template.

variable.command.bansong.title

command

Default commands supported

!cmds

List music commands.

command.cmds

command

Variables supported

{commands} in !cmds

Response value in the cmds command handler's own template.

variable.command.cmds.commands

command

Default commands supported

!togglesr

Toggle song requests enabled state.

command.togglesr

command

Variables supported

{state} in !togglesr

Response value in the togglesr command handler's own template.

variable.command.togglesr.state

command

Invocation contexts supported

Automation

When an enabled automation matches its trigger and Where filter, extract event variables and run actions in order. Individual failures are logged and later actions continue. Cooldown is per automation/platform, memory-only. Positive trigger offsets schedule the sequence.

context.automation

automation

Invocation contexts supported

Timer

Fire independently per selected platform at intervalMin (minimum 1, default 5). Require online status when onlineOnly (default true) and chatLines minimum (default 0). Reset platform line count on eligible firing. Multiple chat actions rotate sequentially/randomly: one selected chat moves to the front, then non-chat actions run. Individual failures log and continue. all/event inner targets are scoped to the eligible platform; explicit different targets are skipped.

context.timer

timer

Invocation contexts supported

Custom command

Match !name or configured aliases; check enabled status, platform, authority, user/global cooldown and configured response/action output. Built-in triggers take precedence over custom commands, then Marketplace commands. Send the configured response before actions. Custom action failures log and continue; a handler returning without a throw is not proof of an external side effect. Broadcaster actors bypass user/global command cooldowns; these cooldowns persist and are scoped per platform.

context.command

command

Invocation contexts supported

SheevPad action button

Click an enabled action button to execute up to 20 stored actions in order. A thrown failure stops remaining actions; visual state toggles only after success. Synthetic username defaults SheevPad, role broadcaster/authority 99, command sheevpad; missing/invalid requested platform defaults Twitch. Buttons are not viewer-triggered events. Groups organize buttons; visual toggle is appearance, not external-device state.

context.pad

pad

Where · Routing supported

Action output routing

event/missing means origin; all means Twitch + YouTube + Kick. Explicit TikTok is supported by eligible actions. Local obs, streamlabs or app events are not chat destinations: choose an explicit output platform when required. Stream title/category use separate three-platform toggles; Conversation Starters has four explicit toggles; trivia has base plus extra targets. Timer gates restrict inner all/event routing.

routing.action-targets

automation · timer · command · pad

Where · Routing supported

Variable resolution

For action templates, event values substitute first, then the global engine. Context-specific title/message/target values can differ from global aliases. Global keys are case-insensitive; event substitution is case-sensitive. Colon arguments support backslash escaping. Unknown placeholders remain literal; null/error/timeout uses declared fallback (default Unavailable). Resolver timeout defaults 2500 ms; final global output cap 480 characters. No general nested-expression language.

routing.variables

automation · timer · command · pad

Where · Routing supported

Installed actions, events and games

The public built-in inventory does not enumerate arbitrary installed packages. Imported app events require an installed active library and subscription; library mappings define extra event.<key> values. Imported action outputs become available only after the producer runs in the current sequence. Marketplace game commands use package instructions and effective configured triggers/aliases; require compatible enabled installed packages. See the action-library and chat-game creator contracts for schemas.

routing.extensions

automation · timer · command · pad

SheevPad navigation supported

SheevPad target

Scroll to the configured targetGroupId. The selected group must exist.

navigation.pad.target

mobile

SheevPad navigation supported

SheevPad next

Scroll to the next group relative to current scroll position; clamp at the last group, without wrapping.

navigation.pad.next

mobile

SheevPad navigation supported

SheevPad previous

Scroll to the previous group relative to current scroll position; clamp at the first group, without wrapping.

navigation.pad.previous

mobile

SheevPad navigation supported

SheevPad favorite

Scroll to layout.favoriteGroupId; a favorite group must be configured and exist.

navigation.pad.favorite

mobile

Variables supported

{delay}

The configured delayed-chat delay in seconds, local to that delayed message.

variable.action.chat_delay.delay

automation · timer · command · pad

Variables supported

{lastActionOk}

Imported-action response helper lastActionOk.

variable.imported.lastActionOk

automation · timer · command · pad

Variables supported

{lastActionType}

Imported-action response helper lastActionType.

variable.imported.lastActionType

automation · timer · command · pad

Variables supported

{lastActionId}

Imported-action response helper lastActionId.

variable.imported.lastActionId

automation · timer · command · pad

Variables supported

{lastActionLabel}

Imported-action response helper lastActionLabel.

variable.imported.lastActionLabel

automation · timer · command · pad

Variables supported

{lastActionNamespace}

Imported-action response helper lastActionNamespace.

variable.imported.lastActionNamespace

automation · timer · command · pad

Variables supported

{lastActionOutputKeys}

Imported-action response helper lastActionOutputKeys.

variable.imported.lastActionOutputKeys

automation · timer · command · pad

Variables supported

{lastActionOutputSummary}

Imported-action response helper lastActionOutputSummary.

variable.imported.lastActionOutputSummary

automation · timer · command · pad

Variables supported

{lastActionMissingOutputKeys}

Imported-action response helper lastActionMissingOutputKeys.

variable.imported.lastActionMissingOutputKeys

automation · timer · command · pad

Variables supported

{lastActionValueCount}

Imported-action response helper lastActionValueCount.

variable.imported.lastActionValueCount

automation · timer · command · pad

Variables supported

{lastActionResponseJson}

Imported-action response helper lastActionResponseJson.

variable.imported.lastActionResponseJson

automation · timer · command · pad

Variables supported

{lastActionValuesJson}

Imported-action response helper lastActionValuesJson.

variable.imported.lastActionValuesJson

automation · timer · command · pad

Variables supported

{lastActionRaw}

Imported-action response helper lastActionRaw.

variable.imported.lastActionRaw

automation · timer · command · pad

Variables supported

{last.<key>}

Package-defined mapped response value.

variable.imported.mapping.last

automation · timer · command · pad

Variables supported

{<namespace>.<key>}

Package-defined mapped response value.

variable.imported.mapping.namespace

automation · timer · command · pad

Variables supported

{<actionId>.<key>}

Package-defined mapped response value.

variable.imported.mapping.action

automation · timer · command · pad

Reference schema 1.0.0 · Source reviewed 2026-10-23. Prepared versions: 2.8.0.