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.