Skip to main content

Chatbox

The Chatbox Flow Editor is a separate flow editor that lives inside the OBS browser source. Instead of calling Twitch APIs or writing to the database, it receives each incoming chat message and uses a flow to decide which visual template variant to render for that message — making your chatbox layout dynamic based on who is talking and how.

Every chatbox flow starts with the Chat Message trigger, which fires once per message. You then route the message through check nodes (subscriber? moderator? emote-only?) and end at a Select Variant effect node that picks how the message looks on screen.

All nodes on this page are Frontend (Chatbox) nodes. They are not available in the main backend flow editor, and they cannot access Redis, the Twitch API, or OBS. They work with the current message or event delivered by the browser source, along with your User Variables and Streamer Variables.

Available Nodes

Trigger

  • Chat Message — Fires for every incoming chat message. Auto-placed at the root of every chatbox flow.

Badge and Role Checks

  • Is Moderator — Passes if the chatter has the moderator badge.
  • Is Subscriber — Passes if the chatter is a subscriber.
  • Is VIP — Passes if the chatter has the VIP badge.
  • Is Broadcaster — Passes if the chatter is the channel broadcaster.
  • Is First Message — Passes if this is the user's first-ever message in the channel.

Message Content Checks

  • Is Emote Only — Passes if the message contains only emotes (Twitch, 7TV, BTTV, FFZ).
  • Is Gigantified — Passes if the message is a power-up gigantified emote.
  • Is Highlighted — Passes if the message was highlighted via channel points.
  • Has Message Effect — Passes if the message has a power-up visual effect.
  • Is Cheer — Passes if the message contains a bits cheer.
  • Is Reply — Passes if the message is a reply in a thread.
  • Is User Intro — Passes if this is a Twitch first-time chatter intro message.
  • Is Custom Redeem — Passes if the message was sent via a custom channel-point redemption.

Shared Chat Checks

  • Is Shared Chat — Passes if the message came from any shared chat session.
  • Is From Other Channel — Passes if the message originated from a different channel via shared chat.

User Checks

Process Nodes (Number Output)

  • Emote Count — Outputs the total number of emotes (any provider) in the message.
  • Message Length — Outputs the character count of the message text.

Routing Utilities

  • Every Nth — Routes every Nth message to Pass, all others to Fail.

Data Nodes

  • Time of Day — Outputs the current hour (0–23) with no input needed.

Variable Nodes

Effect (Terminal)

  • Select Variant — Terminal node that picks which message-template variant to render.