Wrap related nodes in a nested Group, expose typed inputs and outputs, and collapse it into either a regular card with chosen fields or a full-screen step-by-step wizard.
Where: canvas → select 2+ nodes — Group the selection into a collapsible frame
Key ideas
- Group frame: Selecting two or more nodes and grouping wraps them in a NODE_GROUP frame; children become parented to it (extent 'parent') so they move and stay together.
- Exposed inputs and outputs: Map inner handles to named, typed Group sockets. Expanded Groups show every exposed handle; collapsed Groups show the handles selected for the card plus any hidden handle that already has a wire.
- Regular collapsed card fields: In Group settings → Card, use the eye (“Show on card”) to choose the exposed inputs and outputs shown on the regular collapsed card. Drag to reorder them and cycle S / M / L to size each input field or output preview.
- Step-by-step wizard: Wizard mode turns the collapsed card into one Start action that opens a full-screen, paged intake form. It asks for every exposed input—even fields hidden from the regular card—and supports authored steps, required gates, guidance, content blocks, auto-start, and theming.
- Collapse with live wiring: Collapsing hides the children while preserving external connections through the Group’s exposed/proxy handles; expanding restores the full nested canvas.
- Groups organize; List Iterator repeats: Plain Groups still provide nested structure, typed sockets, reusable components, mini apps, and publishing. Their former Group Repeater / loop mode is deprecated; use a paired source and Results List for repetition.
Steps
- Select the nodes and Group them; a colored nested-flow frame appears around the cluster.
- Open Group settings. Add or edit exposed Inputs and Outputs, map them to inner handles, name them, and choose their data types.
- For the regular collapsed card, turn “Show on card” on or off per exposed field, drag the rows into order, and choose S / M / L footprints.
- Collapse the Group to use that compact card. Its chosen inputs become connectable fields and its chosen outputs become previews.
- For guided intake, enable Step-by-step wizard and arrange all exposed inputs into pages. Configure guidance, required questions, auto-start, and theme as needed.
- Open the collapsed Group and click Start; the final wizard step runs the nested flow. Expand or Ungroup whenever you need to edit the inner graph.
Tips
- For new repetition, use Repeat these items or create_list_iteration; never enable a loop/repeater mode on a Group.
FAQ
Why do my external connections survive collapsing a group?
Collapse classifies every edge as internal, external-in, or external-out. Internal edges are hidden; external ones are replaced with proxy edges that attach to proxy-in/proxy-out handles on the frame and are mapped back to the real child nodes for data propagation. Expanding restores the original edges.
What is the difference between an exposed field and “Show on card”?
Exposing a field creates the Group-level socket used for wiring. “Show on card” only decides whether that exposed input/output appears on the regular collapsed card.
Does the wizard include fields hidden from the regular collapsed card?
Yes. The regular card uses the curated “Show on card” subset, while the wizard deliberately pages every exposed input so hidden compact-card fields can still be collected.