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
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
- Choose action category Stream Platform Commands, select Create Twitch Poll, and click Add action.
- Expand the action card. Configure the Fields below; check Editor defaults for your context and any operation-dependent fields.
- 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.
- Choose resource values from real app pickers. Set output Platform separately from the trigger Where setting when the action offers it.
- 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
| Field | Input / options | Defaults / limits | Availability |
|---|---|---|---|
Questiontitle | text | Editor defaults: {"automation":"","timer":"","command":"","pad":""} Maxlength: 4000 Example hint: What should we play next? | Supports variables |
Choicesoptions | text_list | Declared UI default: Editor defaults: {"automation":["Yes","No"],"timer":["Yes","No"],"command":["Yes","No"],"pad":["Yes","No"]} | Supports variables |
Voting duration (seconds)duration | number | Declared UI default: 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.