should / or

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.

should / or v10.4.28

One or all queries provided should match.

In pins 3
  • match
    number

    Define how many queries provided need to match at minimum.

  • query_0 required
    query
  • query_1 required
    query
Out pins 1
  • query
    query

Collects every wired query input into a bool.should clause: {"bool": {"should": [...], "minimum_should_match": N}} : should clauses are optional scoring clauses, but with N defaulting to 1 at least one of them must match unless the surrounding query also has must/filter clauses. Each input object is wrapped in its own bool.must clause; control fragments (fields, limit, sort, ...) are hoisted to the top level. With nothing wired the output is {"bool": {"minimum_should_match": 1}}.

A typical wiring for should / or: fields feeds the query_0 pin; number feeds the number pin; array match include feeds the query_1 pin; the query out pin feeds must.

Studio canvas example for the should / or block: typical wiring for should / or.

Commonly used with

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

  • must: wired in both directions with this block. All queries provided must match.
  • fields: feeds into this block.
  • number: feeds into this block. Generates a valid number from the filled custom value in the blueprint.
  • array match include: feeds into this block. Field array must include given value.
  • match with any: feeds into this block.
  • search: this block feeds into it. searches in the given storage based on a query.

Used in these guides

These documentation pages use or explain this block:

Version history

Introduced in v10.4.28.


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