Command variable usage

Command variables are placeholders in a custom command response. When someone uses the command, Synchra replaces each variable with live data.

Syntax

Variables use curly braces:

{variable_name}
{variable_name option}
{variable_name option "option with spaces"}

Some variables only display data. Others update state, set defaults, or read command input. Check each variable page for the exact behavior.

Example command

Command name:

!countdown

Command response:

The event starts in {countdown 2026-07-01T18:00:00+02:00}

When someone types !countdown, the bot replies with the remaining time until the event.

Common variables

Variable	Use	Example command response
{user}	Mention the target user or the sender.	Hello, {user}!
{sender}	Mention the person who triggered the command.	Requested by {sender}.
{countdown <iso_date>}	Show time left until a date.	Only {countdown 2026-07-01T18:00:00+02:00} left.
{random.int 1 100}	Generate a random number.	Your roll: {random.int 1 100}
{spotify.song_name}	Show the current Spotify song.	Now playing: {spotify.song_name}

Activity variables

For commands run by an activity trigger, use simple variables for the person, value, and other details.

Example response:

Thanks for subscribing for {amount}, {user}!

Variable	Use
{user}	Person who triggered the activity.
{value}	Activity value, adjusted for decimal places.
{unit}	Unit, such as months, subs, or bits.
{amount}	Formatted value with currency or unit, such as $10 or 12 months.
{subtype}	Subscription tier, reward name, or other subtype.
{recipient}	First gift recipient, when available.

See Activity for the full reference and examples. Activity-specific variables require an activity trigger; {user} also works in ordinary chat commands.

Reference

Page	Includes
Account age	Account creation age, date, and date-time
Activity	Activity trigger data
Category	Read or update the stream category
Channel	Channel name
Count	Named counters
Countdown	Time remaining until a date
Faceit	Faceit ELO and level
Followage	Follow duration and follow date
Games	Slots and roulette
Permit manager	Temporary link permits
Points	Points balances and leaderboard data
Quotes	Quote management and display
Random	Random numbers and choices
Sender	Command sender
Spotify	Song and playlist data
Time	Current time by timezone
Title	Read or update stream title
Uptime	Current stream uptime
User	Target user or sender fallback
Viewer stats	Watchtime and stream history
Weather	Weather lookup data