Change from Commerce Search v1 to Commerce Search v2

  • Updated

The default search provider for Optimizely Configured Commerce is Commerce Search v2 (Elasticsearch v7). You can upgrade to Commerce Search v2 (Elasticsearch v7) from Commerce Search v1 (v5) by updating the Search Provider Name and Search Indexer Name in Settings. Because this change requires a Full Rebuild of the search index, the new search provider is down until the rebuild has completed. To avoid this downtime, follow the steps below.

Before changing to Commerce Search v2, check if you currently have custom extensions in Commerce Search v1. If so, you may want to migrate your code first to use Elasticsearch version 7 (default Build Version 2) and third-party search pipelines. See Customize the search rebuild process for information.

  1. Go to Administration > Settings > Search.
  2. Set the Search Indexer Name to Commerce Search v2.
  3. Keep the Search Provider Name as Commerce Search v1 to avoid downtime until the new Elasticsearch v7 index is ready. Elasticsearch v7 receives the default Search Index settings. You can manually update these settings by copying from Elasticsearch v5.

    The Search Indexer Name and Search Provider Name drop-down lists were updated in 5.2.2505.1992+sts and 5.2.2508.2289+lts. See the May 2025 release notes for information.

  4. Click Save.
  5. Go to Marketing > Indexing.
  6. Click Rebuild All.
  7. Wait for the process to finish, and verify that it completed successfully.
  8. Go to Administration > Settings > Search.
  9. Verify that the Search Provider Name has changed to Commerce Search v2.