if

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

if v10.4.28

In pins 3
  • true required
    object
  • false required
    object
  • boolean required
    condition
Out pins 1
  • object
    object

Data selector: outputs the then input when the condition resolves exactly boolean true, otherwise the else input; a nil chosen input becomes {}. Only the chosen side's pure-data producer chain is evaluated -- the losing side is never resolved. Does not gate flow; it picks between two already-wired object values.

A typical wiring for if: OR feeds the condition pin; create document feeds the then pin; update document feeds the else pin; the object out pin feeds reply in JSON.

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:

  • OR: feeds into this block. operator for a set of operands is true if and only if one or more of its operands is true.
  • create document: feeds into this block. Creates a document in the given storage.
  • update document: feeds into this block. Update document in the given storage and creates a revision for it.
  • merge objects: feeds into this block.
  • AND: feeds into this block. operator for a set of boolean operands will be true if and only if all the operands are true.
  • !== true: feeds into this block. checks whether its operands are not equal to true.

Version history

Introduced in v10.4.28.


Back to object Return to the main group to view all sub-groups Back to object: conditions Return to the group to view all blocks within this group