Skip to main content

Set User Team

Runs on: Backend — writes the user team assignment to the database.

The Set User Team effect places a viewer into one of the teams you have configured for your channel. If the viewer is already a member of a different team, they are moved automatically — this node uses move semantics, so a viewer can only belong to one team at a time.

Choose the destination team from the inline dropdown, or wire a number value (a team ID) into the Team handle to select the team dynamically at runtime. The dropdown is hidden when the Team handle has an active connection.

Inputs

NameTypeDescription
useruserThe viewer to assign to the team.
teamnumberThe ID of the team to assign the viewer to. Optional — uses the dropdown selection when not connected.

Configuration

  • Team: A dropdown listing all teams for your channel. Shown only when the Team handle is not wired.

Example

You run a competitive game show on stream where viewers vote to join the Red Team or Blue Team using channel point redeems. Two flows listen for each redeem and route the redeemer's User object to a Set User Team effect, each pre-configured to a different team. Viewers switch teams cleanly with a single redemption.