​

Choice Groups

Choice Groups let you offer multiple alternative nodes at a single step in your flow. At runtime, the user picks which one to use — only the chosen node executes.

​

Creating a Choice Group

1. Select 2 or more nodes — Hold Shift and click each node, or use box-select mode
2. Click the Choice Group button in the toolbar
3. The selected nodes are grouped and assigned a color indicator

Choice Groups are visually indicated by a colored border. The color palette includes teal, purple, pink, yellow, and blue.

​

How Choice Groups execute

When the flow runner reaches a Choice Group:

1. All nodes in the group are displayed as selectable cards
2. The user clicks to choose one option
3. The chosen node’s UI appears and executes normally
4. The selected result’s data flows to the next step

​

Example use cases

Choose a media source: Group a Media Upload, TikTok Scraper, and YouTube Scraper so the user picks how to bring in content. Pick an AI model: Add multiple Text-to-Video nodes with different engines and let the user choose which model to try. Alternative workflows: Group an Image Generation node and a Media Upload node so users can either generate or upload.

​

Customizing the group

Each node in a Choice Group shows a Choice Group section where you can:

• Name the group — Give it a descriptive label (e.g., “Choose Media Source”)
• Change the color — Click the color swatch to pick from the palette
• Remove from group — Click the ✕ to ungroup that node

​

Ungrouping

To remove nodes from a Choice Group:

1. Select the grouped nodes
2. Click Ungroup

The nodes return to sequential execution.