All Release Notes
Product Projection Search and Search Term Suggestions can no longer be activated for new Projects
31 August 2026
HTTP API
Deprecation
Announcement
SearchProduct catalog
The Product Projection Search API lets you retrieve Products using full-text search, filtering, and faceting. This API has been in maintenance mode for over 36 months and receives critical fixes only. It is deprecated in favor of Product Search.
As a first step in this transition, as of 31 August 2026, activating Product Projection Search is no longer generally available. Any Project that was created after 31-08-2026 and does not already have it activated can no longer activate it. Such Projects must use Product Search instead going forward.
Since Search Term Suggestions is activated through the same ProductProjectionsSearch indexing mode as Product Projection Search, it is also affected and can no longer be activated for Projects created after 31 August 2026.
Changes for Projects created after 31 August 2026:
  • Attempting to set mode to "ProductProjectionsSearch" with enabled set to true using the Change Product Search Indexing Enabled update action returns an InvalidOperation error for any Project that does not currently have it enabled.
  • The Merchant Center option to enable Product Projection Search (and, with it, Search Term Suggestions) under Settings > Project settings > Storefront Search is not available.
  • All newly created Projects should use Product Search for storefront search use cases (mode: "ProductsSearch"), which is unaffected by this change and remains fully available to activate.

Existing Projects created until 31 August 2026 are not affected by this change.

If your Project already has Product Projection Search (and Search Term Suggestions) enabled, both continue to work exactly as before. You can keep using the Product Projection Search endpoint and Search Term Suggestions for now, but both remain deprecated and will not receive new features. We don't have a cutoff date for existing usage yet, but we recommend starting to plan your migration to Product Search as soon as possible. Find some initial guidance in our migration guide and in our Product Search learning module.
For further questions regarding your migration path, please contact your Customer Success Manager (CSM) or commercetools support.