Enable Commerce Search v3 in production
3 min
After you successfully test the Commerce Search v3 functionality in your Optimizely Configured Commerce sandbox environment, follow these steps to upgrade production.
Prerequisities
Follow the steps given in Commerce Search v3 prerequisitesCommerce Search v3 prerequisites.
Production steps
Perform the following steps in production:
- Review custom extensions.Review custom extensions.
- Integrate with Optimizely Data Platform (ODP).Integrate with Optimizely Data Platform (ODP).
- Create integration jobs to sync user events and historical orders.Create integration jobs to sync user events and historical orders.
- Update the search configuration:
- Set the Search Indexer Name to Commerce Search v3. Do not yet update the Search Provider Name to Commerce Search v3; use the current Search Provider.

- Perform a full index rebuild and confirm it completes successfully.
- If the rebuild fails or logs show errors or warnings, troubleshoot the issues or contact Optimizely Commerce Support.
- If unresolved, revert the Search Indexer to the previously used version (v1 or v2) and do not proceed to the next step until the issues are resolved.
- If the rebuild is successful, run a few additional rebuilds to ensure stability, and wait at least 12 hours before proceeding to the next step.
- Ensure the Search Provider Name is correctly set to Commerce Search v3.

- Verify that the Autocomplete setting is enabled in the updated Search Provider configuration.
- Replicate any other settings and search parameters that were validated in Sandbox and are required in the Production environment.
- Revert the Search Provider and Indexer to the previously used version if you encounter issues with the new Search Provider in production. Investigate and resolve the problems, or reach out to Optimizely Support for assistance.