Skip to main content
cesteralDocs
FAQContact

Switch Node

Route records to multiple outputs by matching a field against cases

Last updated 24 Jun 2026

The Switch node evaluates one field on each record against a list of cases and routes the record to the matching case's output. Unlike Condition, which has exactly two branches, Switch fans out to as many branches as you define plus an optional default.

When to Use

Use Switch when you need to route records to three or more downstream paths based on a single field — for example, by industry vertical, country, tier, or numeric range.

Configuration

FieldTypeDescription
fieldstringThe record field to evaluate
matchModeexact | contains | regex | rangeHow each case is matched against the field value (default: exact)
caseSensitivebooleanWhether string matching is case-sensitive (default: false)
casesarrayList of cases, each defining one output branch (see below)
hasDefaultbooleanRoute unmatched rows to a default branch, or drop them (default: true)

Case Properties

Which case fields apply depends on matchMode:

PropertyTypeUsed byDescription
labelstringallCase (branch) name shown on the output handle
valuesstringexact, containsComma-separated values to match (e.g. value1, value2)
patternstringregexRegular expression to test against the field
minnumberrangeLower bound of the numeric range
maxnumberrangeUpper bound of the numeric range

Example

Route by company tier:

field: tier
matchMode: exact
caseSensitive: false
cases:
  - label: Enterprise
    values: enterprise
  - label: Mid-Market
    values: mid-market, midmarket
  - label: SMB
    values: smb, small
hasDefault: true

Notes

  • Cases are evaluated in order; the first match wins. Each record exits through exactly one branch.
  • With matchMode: exact or contains, list multiple acceptable values in values, comma-separated.
  • With hasDefault: true, unmatched records exit through the Default handle; with hasDefault: false, they are dropped.
  • For two-branch boolean logic, Condition is simpler.

Related articles

Node Reference Complete reference for all automation node types, organized by categoryCondition Node Branch automation execution on field conditions, routing records to Match or No Match outputsSplit Node Distribute records across multiple outputs by percentage, round-robin, or hash

Still stuck? Browse the FAQ or contact us.