must not

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.

must not v10.4.28

All queries provided must not match.

In pins 1
  • query required
    query
Out pins 1
  • query
    query

Collects every wired query input into a bool.must_not clause: {"bool": {"must_not": [...]}} : this EXCLUDES: any document matching one of these clauses is removed from the result set, and matching clauses do not contribute to scoring. Arrays are flattened in; control fragments (fields, limit, offset, sort, count, ...) are hoisted to the top level. With nothing wired the output is {"bool": {}} and nothing is excluded.

A typical wiring for must not: fields feeds the query pin; the query out pin feeds multiple.

Studio canvas example for the must not block: typical wiring for must not.

Commonly used with

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

  • fields: feeds into this block.
  • multiple: this block feeds into it.
  • search: this block feeds into it. searches in the given storage based on a query.
  • field: feeds into this block. checks if the given field exists in a document. Attention: Checking on a field which has 1024 sub-fields can cause a too_many_clauses exception.
  • array match include: feeds into this block. Field array must include given value.
  • must: this block feeds into it. All queries provided must match.

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