array includes

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

Type Selection Required

This block requires you to select the data type you want to work with. You must manually select the type using the type selector modal. To access the modal, click the white button on the block.

Field Selection Required

This block requires field selection (in). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.

array includes v10.4.28

determines whether an array includes a certain value among its entries

In pins 1
  • Array required
    array
Out pins 1
  • condition
    condition

True when any element of array strictly equals the compared value (which arrives on the pin named after the selected type); false otherwise, including when array is nil or empty. A non-array input on array is treated as a one-element list. Strict equality: numbers by value, strings case-sensitive, no string/number coercion ("1" does not match 1); object or array elements never match.

contains

array includes outputs true when the array contains the value. Here the guid from get guid is checked against an array built with with values, and the result drives a branch: the standard members-only check.

Studio canvas example for the array includes block: checking list membership.

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.
  • get guid: feeds into this block. Returns the guid (field: _meta.guid) of the given user.
  • OR: this block feeds into it. operator for a set of operands is true if and only if one or more of its operands is true.
  • branch: this block feeds into it.
  • AND: this block feeds into it. operator for a set of boolean operands will be true if and only if all the operands are true.
  • array with values: feeds into this block. Creates a new array of given values.

Version history

Introduced in v10.4.28.


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