May 2025 release
10 min
Release: 5.2.2505.1992+sts
Important
Optimizely has found issues with this release that cause integration jobs to fail and the integration server to restart continuously. This issue was resolved in 5.2.2505.2026+sts. You should install this version or later if upgrading.
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.
Note
The May 2025 release is now available for developers to download and work with locally or to request deployments.
Release highlights
- Core Web Vitals / PagebyURL improvement – RetrievePageService now uses database lookup to map a URL path to catalog data.
- SDK LTS – Optimizely Configured Commerce will now publish the long-term support branch as the SDK. See the upgrade instructionsupgrade instructions on how to upgrade to the LTS branch from 5.2.
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
- Updated the VMI location import to not require GUIDs – Removed the billToId and shipToId fields from ParsedItem/VmiLocationUploadRowError interfaces.
- Fixed an issue where CKEditor rendered extra HTML tags – When editing content in the Admin Console, CKEditor was automatically wrapping everything with <html><body>. This caused issues because if an import did not contain them, they would be added the next time a user edited that content. The default Spire behavior extracts the content from <body> to display on the site. CKEditor was modified to not automatically wrap content with <html><body>. However, this removes <html><body> if it exists in the content.
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
Spire enhancements
- Improved performance for Spire sites by responding with "405 Method Not Allowed" for non-GET requests instead of trying to process them.
Other enhancements
- Made PageByURL improvements by updating the RetrievePageService to use a database lookup to map a URL path to catalog data.
- Added a toggle to turn the Intelligent Field Mapper on or off.
- Improved the Intelligent Field Mapper results.
- Renamed the existing Elasticsearch v5 and Elasticsearch v7 options for Search Provider and Search Indexer to Commerce Search v1 and Commerce Search v2, respectively.
- Added the ability for partners to implement calls to the Payment Service to include gateway-specific fields from the Extensions code.
- Updated tracking for the basket order flow to use parent-level tracking instead of variant-level tracking to prevent mismatches.
Security improvements
- Resolved a vulnerability with the X-Forwarded-Host header.
- Improved server-side role-based authorization in the Admin Console.
- Improved the security of Admin Console cookies.
- Updated to send website users email notifications when their email address changes.
- Made other general security improvements.
- Improved the performance of ProductUtilities.IsVisible for GetWishListLineResult.
Bug fixes
- Changed the message "ISC_FRONT_END_PORT environment variable not found" from a warning to informational.
- Fixed a price disagreement with GetCartPricing.
- Fixed an issue in Spire where the Budget Management page retained changes when you navigated from and to the page.
- Fixed an issue where the Order Subtotal and Grand Total wrapped to the next line instead of showing the full number on one line.
- Fixed an issue in Spire where Page URL was not populated in the SendAbandonedCartEmails postprocessor.
- Fixed the validation error that occurred when running the Orders import to ODP for Commerce Search (beta).
- Fixed an unhandled error that occurred when "#" was used within the search field for Commerce Search (beta).
- Fixed an issue in Spire where the credit card type was not automatically updated when you entered credit card information during one-page checkout.
- Fixed an issue where the requisitions page displayed "No requisition found" when there were active requisitions.
- Fixed an issue where the application logs contained some integration job logs.
- Fixed an issue in Spire where some products did not display the product detail page or variant choices.
- Fixed an issue where the hreflang URL did not navigate to a home page in the designated language.
- Fixed an issue in Spire where the properties displayed on the product detail page were from the parent instead of the child.
- Fixed an issue in Spire where the radio buttons did not work in My Account when you changed languages.
- Fixed an issue in Spire where a basket page tracking request was not sent to Product Recommendations when a user clicked into the cart from another product page.
- Fixed an issue where the application logs contained some integration job logs.
- Fixed an unhandled error when you filtered the price matrix.
- Fixed an issue where the Checkout page did not reload correctly when a customer changed the Ship To address on the Checkout page.