---
title: November 2026 release
slug: configured-commerce/release-notes/november-2026-release
createdAt: 2026-11-15T10:44:34.000Z
---

**Release: 5.2.2611.853+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 November 2026 release is now available for developers to download and work with locally or to request deployments.

## Release highlights

- **Optimizely PDF service (Beta)** – Generate large order and product list PDFs more reliably with the Optimizely PDF service. The service runs separately from your website and is now the default PDF engine. If a PDF does not render as expected, set the **Generation Engine** setting back to **IronPDF**.
- **Preview emails from the Email Message Log** – Confirm exactly what a customer received without copying HTML into a separate file. On an **Email Message Logs** entry, click **View email** to display the delivered HTML, not just the designed template.
- **reCAPTCHA for guest checkout** – Stop bots from creating guest accounts on your storefront. Turn on the new **Protect Guest Checkout** setting, and shoppers on Spire storefronts solve a reCAPTCHA challenge before they continue as a guest.
- **Faster restriction group rebuilds** – Get restriction group changes to your storefront sooner on large sites. Search index rebuilds now process restriction groups in a fraction of the time. In a test with 8,700 restriction groups, this step dropped from about 24 minutes to about 30 seconds.
- **Stronger Admin Console and API protection** – Reduced the risk of unauthorized changes to your site and data.

## Breaking changes

### Low risk

- Added the `ConditionBoosts` property to `ISearchRequest<T>` and the `WithConditionBoosts(IEnumerable<SearchConditionBoost>)` method to `ISearchDescriptor<T>` in `Insite.Search.Shared`. Custom implementations of `ISearchRequest<T>` or `ISearchDescriptor<T>` must implement these members to compile.

## Enhancements

- Added the **System Files Retention Days** setting (global, default 180 days), so storage for integration files no longer grows without limit. The **NightlyMaintenance** post processor deletes integration files older than this period from the `_system` folder. The first run after the upgrade deletes the backlog of older files. To keep files longer, increase the setting before you upgrade.
- Improved the nightly maintenance job so it updates top seller data in place instead of deleting and re-adding it. The job runs faster and puts less load on the database, and top seller data stays available while it runs. The upgrade removes duplicate rows from the `ProductTopSeller` table and adds a unique index on `WebsiteId`, `CategoryId`, and `ProductId`. Custom code that inserts duplicate top seller rows now fails.
- Changed the **Customer Type** field in the Admin Console to accept multiple values, so one customer can belong to several customer types. Promotion rules, product restriction rules, and messages that target a customer type now match any of the customer's types. The `Customer.CustomerType` field stores the types as a comma-separated list of up to 255 characters. Custom code, integrations, and reports that compare `CustomerType` to a single value must split the value on commas.
- Added DotLiquid token support to the **Subject** field of email lists. Subjects use the same tokens as the email body, which personalizes them with details such as an order number. If a subject cannot render, Configured Commerce sends the email with the subject as entered. Subjects that contain `[[`…`]]` or `[%`…`%]` pairs now render as DotLiquid templates. Change subjects that use these characters as literal text.
- Made the Buyer 1, Buyer 2, and Buyer 3 roles available in **User Administration** when the **Budget Management** setting is off. You can now use order approval without turning on budgets.
- Changed the **Ship To / Pick Up** column on the Spire **Order Approval** page to sort by company name. This matches the **Order History** and **Invoice History** pages, so approvers see ship-to locations in the same order everywhere.
- Added a warning to Admin Console fields that reference an archived record, such as a customer's **Default Warehouse**. The warning `Value selected is archived, please update selection.` helps administrators find and replace inactive references.
- Rebuilt the most common field types on Admin Console edit pages, such as text, number, toggle switch, and multiple-value fields. The fields look and work as before. Multiple-value system settings now show `Duplicate values are not allowed.` when a value repeats, instead of blocking the save without a message. The Commerce Search v2 synonym editor also no longer shows the **Set Default** link.
- Improved how Spire storefronts recover when you deploy while shoppers are browsing. If a page requests a script file from the previous deployment, Spire reloads the page instead of stalling. Missing script files now return a `no-store` cache header, so a content delivery network (CDN) does not cache the error.
- Added the `LaunchDarkly.ServerSdk` package (version 8.17.1) to the allowed third-party libraries, so extensions can use LaunchDarkly feature flags.
- Changed PunchOut session URLs so each one signs the buyer in only once. The URL also expires after the number of minutes in the **PunchOut Session Expiration Minutes** setting (default 5).
- Added the **PunchOut Framed Session Hours** setting to limit PunchOut sessions in a procurement system's iframe. The default is 8 hours, and the maximum is 72. After that time, the buyer must start a new PunchOut session. Buyers who are in a framed session during the upgrade must also start a new session. The change does not affect carts.
- Changed page version restores in Spire CMS to require permission to edit widgets. Users with only the publisher role can no longer restore page versions. `IPageService.RestorePageVersion` now takes a `websiteId` parameter and returns the restored page ID (`Guid?`) instead of `bool`. Update custom implementations and calls.
- Restricted Admin Console data import to file names that end in lowercase `.xlsx` or `.xls` and contain no path characters. A refused upload returns HTTP 200 with an `errorMessage` value, so automated uploads must check that field.
- Restricted which proxies Configured Commerce trusts for forwarded headers on .NET 10. Configured Commerce trusts the `X-Forwarded-For`, `X-Forwarded-Proto`, and `X-Forwarded-Host` headers only from private network addresses and one Cloudflare hop. A forwarded host that is not one of the website's domain names returns HTTP 400. To trust another proxy, set `ForwardedHeaders:KnownNetworks`, which replaces the default networks.
- Changed Spire to check every redirect against the **Allowed External Redirect Hosts** setting, including redirects rendered on the server. Add each external host that your storefront redirects to.
- Restricted `_system` folder access in the Admin Console file manager and system files API to `ISC_System` and `ISC_Implementer` users. All Admin Console users can still download generated files, such as import and export results.
- Changed the Admin API to refuse `$filter` and `$orderby` queries that reference a property hidden from the caller's role. These queries now return HTTP 403.
- Added the **Maximum Data Set Size (MB)** setting to limit integration data sets from the Windows Integration Service (WIS). The default is 512 MB. If a large integration job fails with an error that names this setting, increase it. Custom `IChunkStorage` implementations must add `Retrieve(Guid id, long maximumBytes)`.
- Limited storefront user tokens to assigned websites when **Restrict Users to Assigned Websites** is on. Other websites also reject the users' existing tokens. Headless or mobile clients that reuse one token across websites must sign the user in on each assigned website.
- Changed newly created custom Admin Console roles so they no longer get **System Settings** access by default. Grant the permission to custom roles that need it.
- Changed the default value of the **Default Email Address** setting to `noreply@commerce.insitesandbox.com`. Websites that never set this setting now send email from this address. To keep a specific sender address, set the setting.
- \*Added the `WithConditionBoosts` method to `ISearchDescriptor`, which lets custom extensions add inline boost rules to Commerce Search v3 search requests. Extensions promote or demote products at request time without changes to core search code. See [Inline boosting](https://docs.optimizely.com/configured-commerce/docs/commerce-search-v3-extensions#inline-boosting).
- \*Added the **Enable Multi-Value Fields**, **Multi-Value Data Fields**, and **Minimum Multi-Value Length** settings for Commerce Search v3 with Google Cloud Retail Search. These settings index each value in a list field separately, so shoppers can find a product by a single part number or keyword code. See [Search settings](https://docs.optimizely.com/configured-commerce/docs/search-settings#google-cloud-retail-search-settings) and [Multi-value field search](https://docs.optimizely.com/configured-commerce/docs/test-commerce-search-v3#multi-value-field-search).
- \*Changed guest checkout to require the **Enable Guest Checkout** and **Allow Account Creation** settings. When **Allow Account Creation** is off, guest checkout is unavailable, and the Account API refuses new guest accounts with HTTP 403. If your site offers guest checkout, turn on **Allow Account Creation**. See [Manage guest access](https://docs.optimizely.com/configured-commerce/docs/manage-guest-access).
- \*Changed Contact Us so submissions go only to the recipients set on the Contact Us widget. Requests for any other recipient return HTTP 400. Headless sites and custom contact forms that send their own recipient must add it to the **Additional Contact Us Recipients** setting. Contact Us accepts five submissions per IP address per hour. The **Max Share Emails Per Ip/Hour** setting limits order and invoice share emails (default 10). Requests over either limit return HTTP 429. Share emails now use the signed-in user's email address as the sender.
- \*Updated the Spire build to pnpm 12.12.1, and moved the `zod` and `immer` dependencies to major versions 4 and 11. Update blueprints that use these packages directly. If you use Volta, remove the `VOLTA_FEATURE_PNPM` environment variable.
- \*Added the **Show Support Information** checkbox to the Unhandled Error Modal page in Spire CMS. When you clear the checkbox, the storefront Unhandled Error modal hides the support section (`timestamp`, `Cloudflare Ray ID`, `Datadog Trace ID`, and `Copy` link). The checkbox is selected by default, so existing sites keep displaying the section after upgrade.
- \*Updated Node.js to version 22.23.5, which includes recent Node.js security fixes.&#x20;
- Improved security.

\* These enhancements were included in hotfixes and are available for 5.2.2610 STS.

## Bug fixes

- Fixed the issue where Commerce Search v3 autocomplete sent shoppers to the wrong category. This occurred when two categories in different parent categories had the same name.
- Fixed the issue where updating a vendor managed inventory (VMI) bin could fail as a duplicate or change a different, archived bin. This occurred when another bin in the same location used the same bin number.
- Fixed the issue where a product's breadcrumb could change unexpectedly when the product had several categories but no primary category. The breadcrumb now uses the product's deepest active category.
- Fixed the issue where a Storefront API request on .NET 10 could report success even though it did not save its changes. The next request on the same connection then failed with a 502 error.
- Fixed the issue where importing Spire CMS content with **Restore Initial Pages** selected returned a 403 Forbidden error.
- Fixed the issue where clicking **Keep me logged in** on the Admin Console session timeout warning displayed `[object Object]` and did not extend the session. This affected .NET 10 sites where administrators sign in with Opti ID.
- Fixed the issue where creating or editing a page variant in Spire CMS, such as for the Home page, could return an unhandled error.
- Fixed the issue where `ISC_System` and `ISC_Implementer` users could not rename or delete folders in the `_system` media folder on .NET 10 sites. System folders, such as `.well-known` and `DataSet`, stay protected.
- Fixed the issue where the Spire **Order Upload** page rejected a valid comma-separated values (CSV) file. This occurred when the file used macOS or Linux line endings and ended with a line break.
- Fixed the issue where Spire could revert a language change made right after closing the new quote information message.
- Fixed the issue where paged warehouse and dealer search results could repeat or skip locations that shared a sort value or distance. This affected storefront pick-up location and dealer searches.
- Fixed the issue where the `GET /api/v1/warehouses` endpoint returned a 500 error when the `sort` parameter was invalid. It now returns 400 Bad Request with a message that lists the accepted values.
- Fixed the issue where an empty `<title>` element in brand content made Spire brand details pages show the URL in the browser tab.
- Fixed the issue where a PunchOut session could not start on a website that had no live default currency. PunchOut now uses the same currency as the storefront.
- Fixed the issue where **Continue Import** in vendor managed inventory (VMI) **Import Counts** imported rows whose product did not match the bin's product. The import now skips these rows.
- Fixed the issue where VMI product exports left out the unit of measure or listed it under the wrong column. Exports now include a **U/M** column.
- Fixed the issue where the Admin Console showed the **Add Role** button to admin users who could not add roles. Now only users with the `ISC_System`, `ISC_Implementer`, or `ISC_Admin` role see the options to add or delete roles.
- \*Fixed the issue where administrators could select an inactive customer as a website user's **Default Customer** in the Admin Console.
- \*Fixed the issue where opening a page by its URL while editing in Spire CMS displayed a blank page.
- \*Fixed the issue where the Admin Console could deactivate users who signed in with Windows single sign-on (SSO) for inactivity. Their **Last Sign In** date now updates when they sign in.
- \*Fixed the issue where Windows Integration Service (WIS) file upload jobs failed with a 403 error. This occurred when the WIS user had only the `ISC_Integration` role.
- \*Fixed the issue where the Spire CMS rich text editor displayed a Froala license warning and saved "Powered by Froala Editor" into page content.
- \*Fixed the issue where the Admin Console Media Manager could not upload JSON files to the `_system` folder on .NET Framework 4.8 sites.
- \*Fixed the issue where an error displayed and prevented saving when you changed a website user's **Default Fulfillment Method** from **Pickup&#x20;**&#x74;o **Ship&#x20;**&#x69;n the Admin Console.&#x20;

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

::File{src="https://api.archbee.com/api/presign/BrbvVORKJ5iIeSMZye5kI/_x8nJsfOYlcW-HBYg5PfU_cumulativebreakingchanges-configuredcommercecloud-522611.xlsx" label="cumulativebreakingchanges_configuredcommercecloud_5.2.2611.xlsx"}
