25 April 2025
Product catalog
We have updated the format for querying Product Attributes. Query Predicates must now include the name of the Product Attribute along with its value.
If you add a new Query Predicate to query Product Attributes without including
attribute-name, then a 400 Bad Request error will occur. Existing queries that use the old format will continue to work; however, we recommend that you include the attribute-name details to enhance the performance of those queries.Product indexing for Products and Product Projection queries is limited. This means that adding a large number of indexes for Attributes can impact the performance of Product and Product Projection queries. As a result, we recommend that you only use a small number of unique query patterns that include Attributes. In addition, we recommend that you instead use the Product Search or Product Projection Search API for all storefront applications.
Incorrect Query Predicate format (no longer accepted):
variants(attributes(value="attribute-value"))
Correct Query Predicate format:
variants(attributes(name="attribute-name" and value="attribute-value"))