Skip to reference

Do · Actions · supported

Create Twitch Poll

Create a poll on your Twitch channel. Question and options support variables and RNG lists.

action.create_twitch_poll · 2.8.0

Browse all entries

Requirements and availability

Twitch Affiliate/Partner broadcaster, channel:manage:polls permission (updated sign-in service plus reconnect), no active poll.

Picker contexts: automation, timer, command, pad.

Behavior

Resolve the question and each ordered option once through the shared variable/RNG engine in Twitch context; validate the final nonempty question (60 characters), 2–5 distinct choices (25 characters each) and whole duration 15–1800 seconds. Create one free-vote poll on the connected Twitch broadcaster. Timers execute this action only on their Twitch firing. Never replace an active poll or retry a creation automatically. Follow progress/final totals through the main window pin area Poll selector; polls close automatically and early ending remains in Twitch.

Configure in the app

Open: Do → Advanced Actions (commands only) → Add action

Steps

  1. Choose action category Stream Platform Commands, select Create Twitch Poll, and click Add action.
  2. Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
  3. Use the Question, Choices/Outcomes and Timing groups. Fill Question and the initial numbered Yes/No rows. Use Add option and the adjacent Remove option button to adjust the list within its displayed limits. Click Variables (the curly-brace button at narrow widths) beside a field to open its chooser; other choosers close, selecting a variable inserts into that field and closes the chooser, and Escape closes it without insertion. For a named RNG list use {list:your-list-name}. Read the resolved-text limits beside the groups, set duration in Timing, and expand Permissions and variable help only when needed. This action always targets the connected Twitch broadcaster; timers run it only on Twitch. No creation happens merely by saving.
  4. Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
  5. Use Move action up / Move action down to position this action, then save the containing command, automation, timer or SheevPad button.

Limitations

  • Poll creation always targets the connected Twitch broadcaster; other platforms are unsupported and non-Twitch timer firings skip it.
  • Picker availability does not supply missing event variables. Check prerequisites and originating provider.
  • An action return value is not automatically a sequence variable. Only documented producers create template outputs.

Fields

FieldInput / optionsDefaults / limitsAvailability
Question
title
text

Editor defaults: {"automation":"","timer":"","command":"","pad":""}

Maxlength: 4000

Example hint: What should we play next?

Supports variables
Choices
options
text_list

Declared UI default: ["Yes","No"]

Editor defaults: {"automation":["Yes","No"],"timer":["Yes","No"],"command":["Yes","No"],"pad":["Yes","No"]}

Supports variables
Voting duration (seconds)
duration
number

Declared UI default: 60

Editor defaults: {"automation":60,"timer":60,"command":60,"pad":60}

Min: 15

Max: 1800

Literal value / selected resource
Twitch Affiliate/Partner broadcaster required. Reconnect Twitch after the updated sign-in service is delivered to grant channel:manage:polls. Final question: 60 characters maximum; each option: 25. Polls use free votes only and close automatically. Manage prediction settlement from the main app's Prediction section or Twitch.
requirements
info

Editor defaults: {"automation":null,"timer":null,"command":null,"pad":null}

Information only

Contract details

Declared Contexts
[
  "timer",
  "automation",
  "command",
  "pad"
]
Picker Contexts
[
  "automation",
  "timer",
  "command",
  "pad"
]
Hidden From Picker
false
Required Variables
[]
Failure Behavior
See the behavior for local skips/errors and context entries for sequence continuation.
Outputs
[]

Examples

Illustrative configuration; replace fixture resources in the editor. This is not an import file.

{
  "title": "What next?",
  "options": [
    "Game A",
    "Game B"
  ],
  "duration": 60
}

Related entries

Source and verification

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

  • src/features/automations.js — ACTION_REGISTRY.create_twitch_poll
  • public/index.html — getBuilderActionEntries / createDefaultAction

Exact build metadata and source revision: version overview and downloads.

Downloads and AI prompt
Download JSONDownload Markdown