September 2025 release

  • Updated

Release: 5.2.2509.1896+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 September 2025 release is now available for developers to download and work with locally or to request deployments.

Release highlights

  • Commerce Search v3 is now generally available – Commerce Search v3 for Optimizely Configured Commerce introduces advanced search technologies tailored for B2B ecommerce platforms. It offers fast, relevant search results powered by Google VertexAI for Commerce and offers machine learning, improving user intent understanding and product ranking. See Commerce Search v3 overview for information.
    • Enhanced search accuracy for higher conversion.
    • Semantic and conversational search for natural interactions.
    • Dynamic filtering for relevant product context.
    • Seamless integration with Optimizely products.
    • Improved customer experience.
    • Fully managed infrastructure for scalability as the business grows.
  • Push notification support has been added for the Configured Commerce Mobile App – You can now enable push notifications in the Admin Console and create a Firebase project to use push notifications for order approvals, rejections, and status updates. Work with your partner or development team to implement this feature.
  • VMI on Storefront has new improvements – Configured Commerce has improved the reordering process for VMI products to prevent over-ordering.
    • Added a setting to Enforce max quantity in orders for VMI locations to prevent orders from being submitted over the maximum quantity. See Add and edit locations.
    • Changed Reorder to Replenish. Replenish All adds products to the cart for each VMI bin below the maximum quantity. Replenish Selected adds products to the cart for each selected bin. If any bin has a count that is greater than or equal to the maximum allowed quantity, a warning displays that some of the bins will not be added to the cart. See Set up and manage products.
  • You can add a URL segment to the Locations page   Site administrators can add URL segments for locations and ensure that they are present on the page and in the site map for the Location Details Page when configured. See Add a location.
  • You can bulk translate product properties using AI (beta) – Configured Commerce lets you use AI to export field translations for multiple products to an Excel file. You can then re-import the file to add the translations.

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

  • Added URL segments to the Locations page – Added methods on a few interfaces to implement the new way dealer URLs are handled. Affected interfaces and their new methods are the following:
    • IDealerService
      • GetDealerByPath
      • GetDealerPage
    • IDealerRepository
      • GetByUrlSegment
    • IPageRetrieveService
      • GetAllPublishedPageUrlsByType

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.

API updates

  • Added the quantity property to Insite.Cart.Services.Dtos.SectionOptionDto.
  • Added the enablePushNotifications property to Insite.MobileApp.WebApi.V1.ApiModels.MobileAppSettingsModel.
  • Added the enforceMaxQuantityInOrders property to Insite.Catalog.WebApi.V1.ApiModels.VmiLocationModel.

Enhancements

Spire

  • Added the ability to control Follow and Nofollow meta directives on Spire CMS pages. See Edit a page.
  • Added a VMI setting to Enforce max quantity in orders to help prevent orders from being submitted over the maximum quantity. See Add and edit locations.

Other

  • Added the ability to enable push notifications for the Configured Commerce Mobile App. This includes a setting in the Admin Console and push notification cleanup during the Nightly Maintenance job.
  • Added a Lookbackdays parameter for Optimizely Data Platform jobs.
  • Improved promotions performance.
  • Added configurable product sections to the Order Confirmation email to match the Order Confirmation page.
  • Added the ability for site administrators to add URL segments for locations.
  • (Beta) Added the ability to use AI to export field translations for multiple products to an Excel file. You can then re-import the file to add the translations.
  • *Added a Generation Timeout setting in the Admin Console to control the number of seconds IronPDF will wait until it determines the PDF generation has timed out.
  • Enabled extensions overrides for Avery label PDF .liquid templates.
  • Added the following packages to the allowlist: Microsoft.IdentityModel.Tokens, Microsoft.Bcl.AsyncInterfaces, and Microsoft.Identify.Client/Microsoft.IdentityModel.Abstractions.
  • *Added the ability to send custom properties to Optimizely Data Platform (ODP).
  • Improved error detection for external identity providers.
  • *Improved the error messaging for CreateElasticsearchProduct.
  • *Improved tolerance for dynamic category issues during Search Rebuild by increasing the default SQL timeout from 90 seconds to 10 minutes.
  • Removed an extra API Call from the Delete Cart Line action.

* These features were included in hotfixes and are available for 5.2.2508 STS.

Bug fixes

  • *Fixed an issue where link jobs did not correctly process step parameters.
  • *Fixed an issue in Spire where the promotion code disappeared when you went to another field during one-page checkout.
  • *Fixed an issue where loading a product line in a non-default language returned the first matching product line with the same UrlSegment, despite different translations for multiple brands.
  • *Fixed an issue where the CMS timed out without warning and gave an unhandled error.
  • *Fixed an issue where importing wishlist products in the Admin Console failed.
  • *Fixed an issue where Spreedly card tokenization did not send the billing address fields.
  • *Fixed an issue with Payment Service where the customer's email address was not passed to the Bambora payment gateway.
  • *Fixed an issue where fixed configurations did not work as expected.
  • *Fixed an issue in Spire where the system gave an error after you created or deleted variants for the header and footer.
  • *Fixed an issue in Spire where changing from preview to edit after you created a page caused a "Page Not Found" error.
  • *Fixed an issue where integration jobs failed when you used custom preprocessors that called IUnitOfWork.Clear() into custom code.
  • *Fixed an issue in Spire where you could not select images on products for custom properties.
  • *Fixed an issue in Spire with one-page checkout where guests could complete checkout even when you disabled the Enable Guest Checkout setting.
  • *Fixed an error that occurred with Spreedly when you tried to use a saved MasterCard.
  • *Fixed an issue where custom widgets did not respect the default field values.
  • Fixed an issue where the Add to List button displayed during a PunchOut session.
  • Fixed an issue in Spire where the product name on the Product Detail page displayed with the wrong header tag.
  • Fixed an issue where an unhandled error occurred when you added multiple products to a cart that already contained a large quantity of products.
  • *Fixed a rendering issue in Spire when you navigated between two different variants of the same page type.
  • *Fixed an issue where impersonating users one after another returned the BillTo of the last customer and caused an error.
  • Fixed a scaling issue with the WishList API.
  • Fix a DateTimeOffset conversion inconsistency between lookup and insert operations for the Price Matrix table.
  • *Fixed an issue where Spreedly was missing a 3DS error message.

* These bug fixes were included in hotfixes and are available for 5.2.2508 STS.

Related Support Articles

None.

Configured Commerce REST APIs

Cumulative breaking changes spreadsheet