Skip to main content

Timeout User

Runs on: Backend — calls the Twitch Helix API to time out the user.

The Timeout User effect puts a viewer in chat timeout for a specified duration. Connect a User object — for example, from a Chat Command trigger — to the User input, and the flow will call Twitch to silence that viewer for the number of seconds you specify.

You can set the duration in two ways: enter a fixed number directly in the node's inline input (shown when nothing is wired to Duration), or connect a number output from another node to dynamically compute the length at runtime. If no duration is provided anywhere the node defaults to 60 seconds.

Inputs

NameTypeDescription
useruserThe viewer to time out. Typically comes from a trigger's User output.
durationnumberHow many seconds the timeout lasts. Optional — uses the inline field value when not connected.

Configuration

  • Duration (inline): The fallback timeout length in seconds, shown when the Duration handle has no incoming connection. Defaults to 60.

Example

A !timeout chat command flow reads the first word after the command as a username, resolves it to a User object, and passes it to Timeout User with a 300-second duration. Any moderator can type !timeout someviewer and the bot handles the rest automatically.