Spending triggers¶
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