if

This block is part of the array group and was last modified in core v10.4.28.

if v10.4.28

Conditional branching for arrays (if.. then.. else..).

In pins 3
  • true required
    array

    Input pin for the "true" branch array.

  • false required
    array

    Input pin for the "false" branch array.

  • boolean required
    condition

    Input pin for the boolean condition.

Out pins 1
  • array
    array

    Output pin for the resulting array based on the condition.

Selects between the two array inputs: outputs the then input when the condition pin resolves to strict boolean true, otherwise the else input. Any non-true value (including truthy non-booleans) falls to else. If the selected input is not an array, outputs an empty array.

branch
condition

A typical wiring for if: search feeds the then pin; remove duplicates feeds the else pin; == feeds the condition pin; the array out pin feeds length.

Studio canvas example for the if block: typical wiring for if.

Commonly used with

In production blueprints, this block is most often wired together with:

  • search: feeds into this block. searches in the given storage based on a query.
  • remove duplicates: feeds into this block. Removes duplicate values from an array.
  • ==: feeds into this block. returns true if the two values are equal.
  • set fields: this block feeds into it. Generates an array of mutations based on the given filled fields.
  • new object: this block feeds into it. Builds a new object filled with the given fields.
  • select field values: feeds into this block. returns an array with values of the given field in this array of objects.

Version history

Introduced in v10.4.28.


Back to array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group