Control Flow Nodes

Control flow nodes determine how data moves through your workflow. Use them to branch, loop, run tasks in parallel, pause execution, handle errors, and compose workflows from reusable subflows.

All Control Flow Nodes

If/Else Condition

The If/Else node evaluates one or more conditions and directs data down the True or False output. Conditions are defined as a JSON array, and you can combine multiple conditions with AND or OR logic.

Parameters

Supported Operators

Example

{
  "conditions": [
    {
      "field": "{{ $json.status }}",
      "operator": "equals",
      "value": "active"
    },
    {
      "field": "{{ $json.score }}",
      "operator": "greaterThan",
      "value": 80
    }
  ],
  "combineWith": "and"
}

Switch

The Switch node provides multi-way branching. Define a value expression and one or more cases. Each case creates a separate output port on the node, allowing you to route data to different downstream branches.

Parameters

Example

{
  "value": "{{ $json.region }}",
  "cases": [
    { "name": "US East", "value": "us-east-1" },
    { "name": "US West", "value": "us-west-2" },
    { "name": "EU", "value": "eu-west-1" },
    { "name": "Default", "value": "*" }
  ],
  "mode": "exact"
}

Subflow

The Subflow node executes another workflow as a step within the current workflow. This enables modular workflow design. Build reusable logic once and invoke it from multiple parent workflows.

Parameters

Example

{
  "workflowId": "wf_abc123",
  "inputMapping": {
    "customerEmail": "{{ $json.email }}",
    "orderId": "{{ $json.orderId }}",
    "items": "{{ $json.lineItems }}"
  },
  "outputMapping": {
    "confirmationNumber": "{{ $json.confirmation }}",
    "estimatedDelivery": "{{ $json.deliveryDate }}"
  },
  "timeout": 30000,
  "passCredentials": true
}

Code

The Code node lets you run custom JavaScript or Python code to process, transform, or generate data. All code executes in a sandboxed Docker container for security. The sandbox is mandatory and cannot be disabled.

Parameters

The items API

Your code receives an items array containing input data from upstream nodes. Each item is a JSON object. Your code must return an array of items as the output.

// JavaScript example: transform and filter items
const results = [];

for (const item of items) {
  // Access input fields
  const name = item.json.name;
  const score = item.json.score;

  // Filter: only keep items with score > 50
  if (score > 50) {
    results.push({
      json: {
        name: name.toUpperCase(),
        score: score,
        grade: score >= 90 ? "A" : score >= 80 ? "B" : "C",
        processedAt: new Date().toISOString()
      }
    });
  }
}

return results;

Loop

The Loop node iterates over an array and executes downstream nodes once for each item. Inside the loop body, you can access:

• {{ $json.item }}, the current array element
• {{ $json.index }}, the zero-based iteration index
• {{ $json.total }}, the total number of items

Parallel

The Parallel node splits execution into concurrent branches. All branches start simultaneously and the node waits for every branch to complete before merging results and continuing the workflow.

Delay

The Delay node pauses execution for a configurable duration. Use it to add wait times between API calls (rate limiting), schedule follow-up actions, or implement polling patterns.

Try/Catch

The Try/Catch node wraps a group of nodes in error handling. If any node in the Try branch throws an error, execution immediately jumps to the Catch branch. The Catch branch receives the error details. An optional Finally branch always executes, regardless of whether an error occurred.