Skip to main content

Streamer Variables

Streamer Variables are custom dynamic values that you define and control. Use them in Flows and overlay widgets to track custom data across your stream — counters, states, messages, or any value you need.

How They Work​

  1. Define a variable with a name and default value
  2. Set the value from Flows (using the Set Broadcaster Variable effect)
  3. Read the value in Flows (using the Broadcaster Variable data node) or in overlay Text widgets

Creating Variables​

  1. Navigate to Streamer Variables in the sidebar
  2. Click Create Variable
  3. Set the variable name and initial value
  4. Save

Text Style Variables​

A variable can have the type Text Style. You pick its value from style tiles instead of typing it, and it always holds a style.

  • In flows, connect a Text Style Data node to Set Broadcaster Variable. The effect's own value field is disabled and says "Connect a Text Style node".
  • In the overlay editor, link widgets to the variable from the style picker. When a flow changes the variable, those widgets redraw live. See Linking a style to a variable.
  • A custom type can have Text Style fields, so one variable can hold a whole theme.

Using in Flows​

Reading Variables​

Use the Broadcaster Variable data node to read the current value:

Setting Variables​

Use the Set Broadcaster Variable effect node to update values:

Using in Overlays​

Reference streamer variables in Text widgets using the double curly brace syntax, similar to special variables.

Using in the Chatbox​

In the Chatbox editor, a Custom Message block can print a streamer variable with the {{streamVar.<name>}} placeholder — for example {{streamVar.deathCount}}.

The Chatbox Flow Editor can also react to streamer variables with the Get Broadcaster Variable and Check Broadcaster Variable nodes.

Use Cases​

  • Death counter — Track deaths in a game, increment from Stream Deck or chat command
  • Status tracker — Display a custom status message that can be updated via Flow
  • Score counter — Track points in a viewer competition
  • Custom greetings — Store and display personalized messages

See Also​