Skip to main content

Select Variant

Runs on: Frontend (Chatbox) — only available in the Chatbox Flow Editor; runs inside the OBS browser source.

The Select Variant effect is the terminal node of every chatbox flow branch. When a message reaches this node, it records the configured variant ID so the chatbox renderer knows which message-template variant to use for displaying that message. No further nodes execute after Select Variant.

Every meaningful path through your chatbox flow should end at a Select Variant node. If a message reaches the end of the flow without hitting any Select Variant node, the chatbox falls back to the default variant. You can place as many Select Variant nodes as needed — one per branch — to give different message types different visual treatments.

The variant dropdown is populated from the templates defined in your chatbox layout configuration. If no templates are loaded (for example when editing outside the chatbox context), you can type a variant UUID directly.

Inputs

NameTypeDescription
messagechat-messageThe chat message being routed. The node does not inspect the message contents — it only records the variant selection.

Configuration

  • Variant: The message-template variant to use for messages that reach this node. Select from the dropdown (populated from your configured chatbox templates) or enter a variant UUID directly.

Example

Build a flow that checks Is Subscriber. Connect the Pass branch to a Select Variant node configured with your "subscriber" template variant (gold username, star icon). Connect the Fail branch to a Select Variant node with your "default" variant. Subscriber messages now display with the gold style; everyone else gets the standard look.