Reference Triggers Spending

Spending triggers

Also on the Cuebot Docs site.

Money spent

Runs every time someone spends money on your stream: a tip, Super Chat, Super Sticker, rant, bits, Kicks, Jewels, a subscription, gift subs or a shop order. The amount is already changed into your chosen currency. Names on the Never list (like Anonymous) still run it. Good for thanking big spenders or showing a running total.

Setting	What to put in
Platform	Only for this platform, like Twitch or Ko-fi. Leave it empty for every platform.
Minimum amount (your currency)	Only when the purchase is worth at least this much, in your chosen currency. 0 = every purchase. Starts as: 0.

Variables you get

Variable	What it holds
%user%	Who spent the money
%platform%	Where they spent it, like Twitch, YouTube, Kick, Rumble, Streamlabs or Ko-fi
%label%	What it was, like Cheer, Super Chat, Rant, Subscription or Gift subs
%amount%	What it is worth, in your chosen currency, like 4.99
%currency%	Your chosen currency, like USD
%formattedAmount%	The amount with its currency sign, like $4.99
%paidAmount%	What they actually paid: the money in their own currency, or the number of bits, Kicks, Jewels or subs
%paidCurrency%	The currency they paid in, like EUR, or Bits, Kicks, Jewels, Subscription or GiftSubscription
%unit%	What it was counted in: Money, Bits, Kicks, Jewels, Subscription or GiftSubscription
%quantity%	How many: the money in their own currency, or the number of bits, Kicks, Jewels or subs
%tier%	The sub tier (1, 2 or 3 on Twitch, the membership level on YouTube); empty for everything else
%streamTotal%	Everything this person has spent this stream on that platform, in your currency
%rank%	Their place on this stream's top spenders list (1 = the top spender)
%sessionId%	The stream's internal id

Type id: spending.recorded

New top spender this stream

Runs when somebody new becomes the top spender of this stream. Good for a "new top spender!" alert or chat message.

Setting	What to put in
List	Which list. All platforms = the top spender across every platform changed. A platform name like Twitch = the top spender on that platform changed. Any = either. Starts as: All platforms.

Variables you get

Variable	What it holds
%user%	The new top spender
%platform%	Their platform
%total%	Everything they have spent this stream, in your chosen currency
%currency%	Your chosen currency, like USD
%formattedTotal%	The total with its currency sign, like $25.00
%previousUser%	Who was the top spender before (empty when nobody was)
%previousPlatform%	The platform of the previous top spender
%previousTotal%	What the previous top spender had spent
%scope%	Which list changed: All platforms, or the platform's name

Type id: spending.topSpenderChanged