---
title: May 2025 release
slug: configured-commerce/release-notes/may-2025-release
docTags: 
createdAt: 2026-08-18T12:29:50.000Z
---

**Release: 5.2.2505.1992+sts**

:::hint{type="warning"}
**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.

:::hint{type="info"}
**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 instructions](docId\:p2aGwJOyRnFq3_V0YVe2-) 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](docId\:uxASylNH79zHfoHfn43R5), 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](docId\:PQcv8ijMI3FR57VfLniwM) 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

- [Fixed an issue in Spire where enabling Server-Side Rendering (SSR) on the storefront led to unexpected redeployments](https://support.optimizely.com/hc/en-us/articles/36792964995725-SA1698953-Spire-Redeployment-Triggered-by-Search-Term-Redirects-with-Server-Side-Rendering-Enabled).
- 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 a duplicate header was added for every request to Adyen](https://support.optimizely.com/hc/en-us/articles/35907864051085-SA1680155-Adyen-Request-Header-Grows-Infinitely).
- 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.

### Related Support Articles

- [SA1680155-Adyen Request Header Grows Infinitely](https://support.optimizely.com/hc/en-us/articles/35907864051085-SA1680155-Adyen-Request-Header-Grows-Infinitely)
- [SA1698953-Spire Redeployment Triggered by Search Term Redirects with Server-Side Rendering Enabled](https://support.optimizely.com/hc/en-us/articles/36792964995725-SA1698953-Spire-Redeployment-Triggered-by-Search-Term-Redirects-with-Server-Side-Rendering-Enabled)

### [Configured Commerce REST APIs](docId:_ktNaF8fv6Kleyg8Y2j6q)

### Cumulative breaking changes spreadsheet