Switch

Switch evaluates the value expression and routes to the first matching case, falling back to the default output.

Purpose and use: Select one route among configured cases; use for multi-way typed matching or ordered rules.

Configuration: Optional configVersion (2 in palette); mode (value or rules, default value); expression (default {{ $json.value }}); cases array; and defaultLabel (default Default). V2 cases have stable case IDs; value mode case values are typed string/number/boolean literals, not expressions. Rules use all/any and shared condition operators.

Input/output and routing: One input; one output handle per configured case ID plus default. First matching configured case is active; otherwise default. Connect edges using stable case IDs, not labels.

Expressions: Value mode evaluates expression; rules mode evaluates each case’s left/right expressions. Case values in typed V2 value mode are literals.

Errors/effects: Unresolved/empty expressions select default with step diagnostics. Invalid/duplicate case IDs, labels, handles, or routing fail graph validation. No direct write; downstream routes may write.

Example configuration — fields validated against the 1.1.1 node schema; replace the identifiers with your own: {"configVersion":2,"mode":"value","expression":"{{ $json.status }}","cases":[{"caseId":"open","value":"Open"}],"defaultLabel":"Other"}. Expected result: the matching case handle on a strict typed match, otherwise default.