Condition

The Condition block allows you to branch your workflow execution path based on boolean expressions. It evaluates conditions and routes the workflow accordingly, enabling you to create dynamic, responsive workflows with different execution paths.

Overview

The Condition block enables you to:

How It Works

The Condition block operates through a sequential evaluation process:

1. Evaluate Expression - Processes the boolean expression using current workflow data
2. Determine Result - Returns true or false based on the expression evaluation
3. Route Workflow - Directs execution to the appropriate destination block based on the result
4. Provide Context - Generates metadata about the decision for debugging and monitoring

Configuration Options

Inserting a branch after wiring outputs

Click + Add condition between cards to insert a blank condition at that position. The last insertion button, immediately before Else, appends a condition. There is no confirmation dialog or popover. Existing connections remain attached to their conditions; the new condition starts unconnected.

Drag a condition by its left-hand grip, or use its up/down buttons, to change evaluation order. Expressions and connections follow the condition. Else always remains last. Each insertion or completed reorder is one undo/redo step. Press Escape to cancel an active drag. If another edit conflicts, review the current branches before trying again.

Conditions

Define one or more conditions that will be evaluated. Each condition includes:

• Expression: A data expression that evaluates to true or false (see Supported expression syntax)
• Path: The destination block to route to if the condition is true
• Description: Optional explanation of what the condition checks

You can create multiple conditions that are evaluated in order, with the first matching condition determining the execution path.

Condition Expression Format

Conditions use a safe, data-only subset of JavaScript expression syntax and can reference input values from previous blocks. Expressions are evaluated by a strict interpreter — not eval() — so only the constructs listed under Supported expression syntax are available.

// Check if a score is above a threshold
<agent.score> > 75

Accessing Results

After a condition evaluates, you can access its outputs:

• <condition.result>: Boolean result of the condition evaluation
• <condition.matched_condition>: ID of the condition that was matched
• <condition.content>: Description of the evaluation result
• <condition.path>: Details of the chosen routing destination

Advanced Features

Complex Expressions

Combine operators and the supported string, array, and number methods:

// String operations
<user.email>.endsWith('@company.com')

// Array operations
<api.tags>.includes('urgent')

// Mathematical operations
<agent.confidence> * 100 > 85

// Nested values and indexes
<api.result>.status === 'ok' && <api.items>[0].id === 42

// Fallback for a null value
(<api.label> ?? 'none') !== 'none'

Supported expression syntax

Conditions are evaluated by a strict interpreter over your workflow data. Anything outside this list fails the step with a clear error rather than running.

Supported

• Literals: numbers, single- or double-quoted strings, true, false, null
• References to previous block outputs, and reads beneath them — <api.result>.status, <api.items>[0], <api.map>['key']
• .length on strings and arrays
• Comparison: ===, !==, ==, !=, <, >, <=, >=
• Logical and unary: &&, ||, !, ??, unary -, typeof
• The conditional (ternary) operator: <agent.score> > 50 ? 'high' : 'low'
• Arithmetic and string concatenation: +, -, *, /, %
• String methods: includes, startsWith, endsWith, indexOf, lastIndexOf, trim, trimStart, trimEnd, toLowerCase, toUpperCase, slice, substring, charAt, at, concat, split, replace, replaceAll, toString
• Array methods: join, flat
• Number methods: toFixed, toPrecision
• Array and object literals — a block reference whose value is an array or object is interpolated as a JSON literal, so <api.tags>.includes('urgent') runs as ["urgent","billing"].includes('urgent')

Not supported

• new (including new Date(...)), regular-expression literals, and template literals
• Arrow functions and any callback-taking method (map, filter, some, …)
• Assignment and optional chaining (?.)
• Globals such as Math, JSON, Date, process, and fetch

Limits

A Condition block supports at most 100 conditions, and each expression is limited to 2,000 characters. Exceeding a limit fails the step with a clear error.

Multiple Condition Evaluation

Conditions are evaluated in order until one matches:

// Condition 1: Check for high priority
<ticket.priority> === 'high'

// Condition 2: Check for urgent keywords
<ticket.subject>.toLowerCase().includes('urgent')

// Condition 3: Default fallback
true

Error Handling

An expression that cannot be evaluated fails the step — it does not quietly fall through to else. This applies to:

• A reference that does not resolve to any block, including inside a compound && / || expression
• Syntax outside the supported subset, such as new Date(...) or a regular-expression literal
• An expression or condition list that exceeds the documented limits

null and undefined values are evaluated safely — compare them explicitly with === null or supply a fallback with ??.

Inputs and Outputs

Example Use Cases

Customer Support Routing

Content Moderation

User Onboarding Flow

Best Practices

• Order conditions correctly: Place more specific conditions before general ones to ensure specific logic takes precedence over fallbacks
• Include a default condition: Add a catch-all condition (true) as the last condition to handle unmatched cases and prevent workflow execution from getting stuck
• Keep expressions simple: Use clear, straightforward boolean expressions for better readability and easier debugging
• Document your conditions: Add descriptions to explain the purpose of each condition for better team collaboration and maintenance
• Test edge cases: Verify conditions handle boundary values correctly by testing with values at the edges of your condition ranges