November 2026 release
8 min
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 [email protected]. 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.
- *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 and 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.
- *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.
- 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 to Ship in the Admin Console.
* These bug fixes were included in hotfixes and are available for 5.2.2610 STS.