Intermediate

Switch Node: Multi-Branch Prompt Engines & Variant Hot-Swapping

Create multi-branch dynamic switcher nodes to test tone, persona, or test-case variants with zero canvas clutter.

# Switch Node

The **Switch Node** (Option Select Node) transforms static prompt workflows into dynamic, interactive prompt engines. Instead of duplicating entire node graphs to test variations, a Switch Node lets you route multiple upstream branches through a single selector.

---

## 1. Visual Anatomy & Port Architecture

- **Header Bar**: Clean title with collapse chevron.
- **`ALL OUT` Port**: Gold/Amber circular handle (`#F59E0B`) on the top-right border emitting the currently selected branch.
- **Option Input Slots (`OPTION 1`, `OPTION 2`, ...)**:
  - **Left Gray Handle (`●`)**: Receives an upstream text or prompt stream.
  - **Right Amber Handle (`●`)**: Pass-through handle for that specific branch.
- **`● (+) ADD INPUT`**: Adds additional branch options with one click.
- **`SELECTED INPUT` Dropdown**: Segmented dropdown selector allowing you to pick which option is currently active.

---

## 2. Zero-Latency Hot Swapping

When you change the selected option in the dropdown:
- Downstream Output Hubs and AI Agent nodes are updated **instantly** in real time.
- You never have to disconnect or re-wire noodles between variants.
- Unchosen upstream branches are completely bypassed by the compiler, saving memory and keeping prompt execution deterministic.

---

## 3. Best Practices & Use Cases

- **Tone & Persona Testing**: Route "Professional", "Casual", and "Technical" prompt variations into a single downstream LLM prompt.
- **Aspect Ratio & Style Selectors**: For image generation workflows (Midjourney, Stable Diffusion), quickly toggle camera lenses, lighting setups, or aspect ratios (`16:9`, `9:16`, `1:1`).
- **A/B Headline Testing**: Connect different marketing hooks and review their compiled Output Hub versions side-by-side.