if

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

Connection Type

This block connects from a query type block. Make sure to connect this block to the appropriate left-hand side connection.

if v10.4.28

In pins 3
  • then required
    query
  • else required
    query
  • boolean required
    condition
Out pins 1
  • query
    query

Passes through exactly one input: the flow engine pre-selects the then or else pin from the condition, and this block outputs that pin's value unchanged (nil when the selected pin is unwired). The condition itself is not evaluated here. Does nothing during precompile.

A typical wiring for if: must feeds the then pin; filter feeds the else pin; is not empty feeds the condition pin; the query out pin feeds multiple.

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:

  • get fields: feeds into this block. Gets the selected fields from the given object.
  • multiple: this block feeds into it.
  • must: feeds into this block. All queries provided must match.
  • search: this block feeds into it. searches in the given storage based on a query.
  • filter: feeds into this block. Build a custom query using higher-level bool query.
  • is not empty: feeds into this block. checks if the value is filled (not empty).

Version history

Introduced in v10.4.28.


Back to query Return to the main group to view all sub-groups Back to query: misc. Return to the group to view all blocks within this group