Added support for filter expression fields to Product Search in GraphQL | HTTP API

Added support for filter expression fields to Product Search in GraphQL

28 January 2026

Composable Commerce

HTTP API

Enhancement

GraphQLProduct catalogSearch

We've added the and, or, not, filter and fuzzy fields to the filter expression available in GraphQL schema for Product Search BETA. With this enhancement, you can now use filter compound expressions and fuzzy search in GraphQL productsSearch queries as well as in sort filters. Before, you could use these fields in filter expressions in the Product Search REST API only.

Example query:

Search for products named 'T-shirt' and sorting by SKU while limiting sorted hits to those matching red color and small sizesgraphql

{
  productsSearch(
    query: {fullText: {field: "name", value: "T-shirt", language: "en"}}
    sort: [{
      field: "variants.sku",
      order: asc,
      filter: {
        and: [
          {exact: {field: "variants.attributes.color", fieldType: set_text, value: "red"}},
          {fuzzy: {field: "variants.attributes.size", fieldType: set_text, value: "*S", level: 2}}
        ]
      }
    }]
  ) {
    results {
      id
    }
  }
}

Changes:

[GraphQL API] Added the and, or, not, filter, and fuzzy fields to the SearchFilterExpressionInput input type.

The following changes were introduced in terms of GraphQL SDL:

extend type SearchFilterExpressionInput {
  and: [SearchQueryInput!]
  or: [SearchQueryInput!]
  not: [SearchQueryInput!]
  filter: [SearchQueryInput!]
  fuzzy: SearchFuzzyExpressionInput
}