Core Plugins and tasks If

Core Plugins and tasks If

Certified

Branch tasks based on a rendered condition.

Renders condition and coerces it to boolean (the strings false, 0, -0, an empty string and null are false; every other value is true). Executes then when true, else when false, with optional errors/finally blocks.

Frequently used after previous task results to drive control flow.

yaml
type: io.kestra.plugin.core.flow.If
yaml
id: if
namespace: company.team

inputs:
  - id: string
    type: STRING
    required: true

tasks:
  - id: if
    type: io.kestra.plugin.core.flow.If
    condition: "{{ inputs.string == 'Condition' }}"
    then:
      - id: when_true
        type: io.kestra.plugin.core.log.Log
        message: "Condition was true"
    else:
      - id: when_false
        type: io.kestra.plugin.core.log.Log
        message: "Condition was false"
Properties

The If condition which can be any expression that evaluates to a boolean value.

Boolean coercion evaluates the strings 'false', '0', '-0', an empty string and null to false; all other values evaluate to true.

Min items1

List of tasks to execute if the condition is true

List of tasks to execute if the condition is false

List of tasks to execute in case of errors of a child task

Condition evaluation result