match with any

This block is part of the query group and was last modified in core v12.0.5.

Field Selection Required

This block relies on a field that you select to perform its data actions. You must manually select the field you want to use in your flow using the field selector modal. To access the modal, click the white button on the block.

Connection Type

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

Parent Requirements

This block requires specific parent elements: query_bool_must, query_bool_must_not, query_bool_filter, query_bool_should, query_first_defined. Ensure this block is placed within the appropriate parent context.

match with any v12.0.5

In pins 2
  • value required
    array

    An array of possible values to run the terms against

  • Boost
    number

    Default 1.0

Out pins 1
  • query
    query

Emits a terms clause matching documents whose bound field equals ANY of the values in the value array pin (OR semantics); value-typed fields target the .keyword sub-field and boost defaults to 1. An unwired, non-array or empty value pin does NOT match everything : it falls back to the sentinel {"terms": {"_meta.created": [-2]}}, which matches nothing. A missing field binding outputs nil: no clause at all.

terms fields

match with any matches documents whose field equals any value in the array on its pin, built here with with values. The query feeds filter and from there search.

Studio canvas example for the match with any block: matching any of several values.

Commonly used with

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

  • filter: this block feeds into it. Build a custom query using higher-level bool query.
  • must: this block feeds into it. All queries provided must match.
  • get fields: feeds into this block. Gets the selected fields from the given object.
  • select field values: feeds into this block. returns an array with values of the given field in this array of objects.
  • with values: feeds into this block. Returns an array of values.
  • should / or: this block feeds into it. One or all queries provided should match.

Version history

Introduced in v12.0.5.


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