Skip to main content

User Variables

User Variables are custom values stored per viewer — every viewer in your channel can have their own copy of a variable. Where Streamer Variables hold a single value for your whole channel, a User Variable like points or wins holds a separate value for each person who watches.

Use them to track viewer-specific data: loyalty points, win/loss records, quest progress, personal greetings, or anything you want to remember about an individual viewer.

How They Work​

Each User Variable has a name and a typed value. The supported types match Streamer Variables — text, number, boolean, and list variants. A value is stored against one viewer at a time, identified by their Twitch account.

Managing User Variables​

  1. Navigate to User Variables in the sidebar
  2. Choose a viewer to inspect — pick one from the list of viewers that already have variables, or enter a viewer's Twitch user ID
  3. Add, edit, or remove that viewer's variables

Values can also be created and updated automatically from Flows, so the management page is mainly for inspecting and correcting data by hand.

Using in Flows​

Reading a viewer's variable​

The Get User Variable node reads the current value for the viewer involved in the flow:

Setting a viewer's variable​

The Set User Variable effect writes a new value for that viewer — see Set User Variable.

Branching on a viewer's variable​

In the Chatbox Flow Editor, the Check User Variable node compares a viewer's variable against a value and routes the message accordingly — see Check User Variable.

Using in Chatbox Messages​

In the Chatbox editor, a Custom Message block can print a viewer's variable directly with the {{userVar.<name>}} placeholder, where <name> is the variable name:

{{userVar.points}} → the current viewer's points value

You can supply a fallback for when the viewer has no value yet:

{{userVar.points | "0"}}

Broadcaster (channel-wide) variables work the same way with the {{streamVar.<name>}} placeholder. For example, a Custom Message reading:

{{username}} has {{userVar.points}} points — channel goal: {{streamVar.pointGoal}}

Use Cases​

  • Loyalty points — give each viewer a running point total and display it next to their name
  • Win/loss records — track per-viewer stats for channel games
  • Personal greetings — store a custom welcome line for regulars
  • Quest progress — remember how far each viewer has gotten in a channel activity

See Also​