July 2025 release

  • Updated

Release: 5.2.2507.1562+sts

The following is a list of the release's bug fixes and enhancements. Some bug fixes may address existing support articles. A comprehensive list is at the bottom of this page.

The July 2025 release is now available for developers to download and work with locally or to request deployments.

Release highlights

  • Introducing Optimizely Opal Chat for Configured Commerce – Use Opal Chat to learn how to complete tasks in the Admin Console, get information about releases, or generate product descriptions. See Optimizely Opal Chat in Configured Commerce for information.

    You must have Opti ID and be on 5.2.2506.1916+sts or later to use Opal Chat.

Breaking changes

Binary breaking changes do not necessarily require code changes but rather just a recompilation of the project. This section describes breaking changes to method signatures or method behaviors in Optimizely Configured Commerce.

Low risk

  • Ensure canonical URL in page metadata always matches case with the sitemap – GetProductMapperBase now requires an additional constructor parameter, SeoSettings. Any customized mappers whose inheritance tree includes this class must update their constructors to accept and forward an instance of SeoSettings.

Partners/Developers: At the bottom of this page, you can view a cumulative list of breaking changes, including Spire breaking changes. The spreadsheet has two tabs: one for cumulative breaking changes and one for Spire breaking changes.

Database changes and updates

No significant changes.

Library changes and updates

No significant changes.

Enhancements

  • Added Opal Chat to Configured Commerce. You must have Opti ID to use Opal Chat.
  • Added region information to the offline orders export for the Product Recommendations integration.
  • Added Product - Default Visibility to the Product Recommendations feed.
  • Updated the allowed roles for the ODP integration settings for Commerce Search v3 to be ISC_System and ISC_Implementer.
  • Updated the Rebuild Sitemap job to not remove current active sitemaps until a new sitemap is generated.
  • Added the Microsoft.IdentityModel.Tokens namespace to the allow list.
  • Added support for "emails" as the primary claim type when you use OpenID Connect as an SSO provider
  • Updated the full search index rebuild to report expected and actual Elasticsearch records upon completion. If the count is not correct, it does not switch to the new index.
  • Enabled caching for the /userfiles endpoint so that it returns a 304 if a browser already has the current image.
  • Improved wishlist performance by replacing multiple individual product visibility checks with a single batch call, reducing search provider round trips, memory usage, and significantly improving response times for large wishlists.

Bug fixes

  • Fixed an issue where the Rebuild Index buttons were disabled if there was a queued job.
  • Fixed serialization gaps for the WIS job definition.
  • Fixed an issue where the Admin Console used a vanity URL instead of the templated URL when you launched a site's CMS.
  • Optimized the attribute value translation in GetProductData.
  • Fixed an issue where AddPaymentProfile did not log the responseString object.
  • Fixed an infinite loop with some integration jobs.
  • Fixed an issue where users without a VMI_User or VMI_Admin role could still access order details for a VMI order.
  • Fixed an issue in Spire where a URL redirect for a search term that went to a brand page caused the search result term and breadcrumb to display as "undefined."
  • Fixed an issue in Spire where the Order Notes field was displaying smaller.
  • Fixed an issue where the Commerce Search v3 indexing process failed due to an out-of-memory exception.
  • Fixed an issue in Spire where a user could not proceed from cart to checkout when there was no inventory available and you had backorders enabled.
  • Fixed an issue where the image picker control became unusable in table view, preventing you from setting a value without using a SQL query.
  • Fixed an issue in Spire where you could not proceed to checkout when the Inventory Service was unavailable, even if backorders were enabled.
  • Fixed an issue where custom settings were incorrectly displayed when you turned off "Enable Boosting by Stock" in the Extensions DLL.

Related Support Articles

None.

Configured Commerce REST APIs

Cumulative breaking changes spreadsheet