ByteChef LogoByteChef

Condition

Directs a stream based on true/false results of comparisons.

Type: condition/v1


Properties

NameLabelTypeDescriptionRequired
rawExpressionRaw ExpressionBOOLEAN
Options true, true
Set condition as raw expression or list of conditions.true
conditionsOR ConditionsARRAY
Items [[{STRING(type), BOOLEAN(value1), STRING(operation), BOOLEAN(value2)}(boolean), {STRING\(type), DATE_TIME\(value1), STRING\(operation), DATE_TIME\(value2)}\(dateTime), {STRING(type), NUMBER(value1), STRING(operation), NUMBER(value2)}(number), {STRING\(type), STRING\(value1), STRING\(operation), STRING\(value2), STRING\(value2)}\(string)]]
OR Condition array that contains AND Condition arraysfalse
expressionExpressionSTRINGThe raw expression.true

Additional Instructions

The Condition flow control evaluates a logical expression and routes execution down one of two paths: true or false. Use it for binary decisions — threshold checks, validation, or simple yes/no branching.

Usage

Step 1: Add Condition to your workflow

Select Condition from the Flows component panel and add it where the workflow needs to branch. The node creates two paths, True and False.

Step 2: Choose how to express the condition

The Raw Expression toggle decides which of two editors you get. See Expressions for the full expression language.

Raw Expression enabled — write the expression directly in the Expression field:

${order_1.total} > 1000
${user_1.verified} == true && ${user_1.age} >= 18

Values like ${order_1.total} come from data pills — output produced by an earlier component or trigger, or a value you configured by hand.

Raw Expression disabled — build the condition visually. Conditions are structured as OR groups, each containing one or more AND conditions:

  1. Click Add OR Condition to create a group.
  2. Inside a group, click Add AND Condition to add a comparison.
  3. Pick the comparison type: Boolean, Date Time, Number, or String.

Each comparison takes Value 1, an Operation, and (for every operation except Empty) Value 2.

Step 3: Build the two paths

Add the components that should run when the condition is true to the True path, and those for the false case to the False path.

Available operations

The operations offered depend on the comparison type you pick.

String

OperationMeaning
EqualsExact match
Equals Ignore CaseCase-insensitive match
Not EqualsNot equal to
ContainsValue 1 includes Value 2
Not ContainsValue 1 does not include Value 2
Starts WithValue 1 begins with Value 2
Ends WithValue 1 ends with Value 2
RegexValue 1 matches the regular expression in Value 2
EmptyValue 1 is an empty string — takes no Value 2

Number

OperationMeaning
EqualsValue 1 equals Value 2
Not EqualsValue 1 does not equal Value 2
GreaterValue 1 is greater than Value 2
Greater or EqualsValue 1 is greater than or equal to Value 2
LessValue 1 is less than Value 2
Less or EqualsValue 1 is less than or equal to Value 2
EmptyValue 1 is absent — takes no Value 2

Boolean

OperationMeaning
EqualsValue 1 equals Value 2
Not EqualsValue 1 does not equal Value 2

Date Time

OperationMeaning
AfterValue 1 is later than Value 2
BeforeValue 1 is earlier than Value 2

How is this guide?

Last updated on

On this page