Documentation
All Release Notes
Deprecated Product Projection parameters in Product Search
11 December 2025
Composable Commerce
HTTP API
Deprecation
Announcement
Product catalogSearch
We have deprecated data integration with Product Projection parameters in Product Search that was in public beta until now. This change affects you if you're using the productProjectionParameters field in your ProductSearchRequest to retrieve product data alongside search results.
During the beta period, we introduced the productsSearch GraphQL query. We now recommend this as the primary method to integrate product data with search results. With the GraphQL query, you can request only the fields needed for rendering, reducing payload size and improving page performance.

Behavior during deprecation period:

  • Product Search requests that include productProjectionParameters continue to succeed, but the field is treated as deprecated and will no longer receive feature updates.
  • Future releases of our official SDKs will indicate this feature is deprecated and support it until decommissioning.
No immediate action is required. We recommend auditing your usage of this feature and planning to migrate to one of the alternative data integration approaches before the decommissioning date to ensure uninterrupted service:
  • Use GraphQL productsSearch query to fetch search results and select only the required product fields.
Search query fetching selected product fields, the price in USD, and one attributegraphql
{
  productsSearch(
    query: {fullText: {field: "name", value: "Skirt", language: "en"}}
  ) {
    results {
      product {
        masterData{
          current{
            masterVariant{
              sku
              images{
                url
              }
              price (
                currency: "USD"
                country: "US"
              ) {
                value {
                  centAmount
                }
              }
              attributesRaw(includeNames: "designer"){
                name
                value
              }
            }
          }
        }
        }
      }
    offset
    limit
    total
  }
}
  • Use the Product Projection API to query Product Projections by the IDs returned from Product Search.
  1. Run Product Search and collect product IDs from results.
  2. Fetch Product Projections by IDs:
Example request to fetch Product Projections by Product IDshttp
GET /{projectKey}/product-projections?where=id%20in%20("id-1","id-2","id-3")&staged=false

You can include additional query parameters to filter results by price, locale, and attributes as needed to reduce response size. To maintain the order of results, apply the same sorting logic on the Product Projections query as used in the Product Search request.

We don't have an exact date yet for when the deprecation period will end. We will announce it at least three months before decommissioning. Subscribe to our release notes to not miss any updates.

Changes: