Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Release Notes

Get an overview of the things changed and fixed in each version of Umbraco Commerce.

In this section, we have summarized the changes to Umbraco Commerce released in each version. Each version is presented with a link to the Commerce issue tracker showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.

If you are upgrading to a new major version, check the breaking changes in the Version Specific Upgrade Notes article.

Release History

This section contains the release notes for Umbraco Commerce 17 including all changes for this version.

17.2.4 (7th Sep 2026)

  • Fix analytics dashboard widgets overlapping when the browser window is resized #884

  • Fix custom cart filters registered via WithCartAdvancedFilters() being silently ignored #885

  • Fix order cleanup failing on SQL Server with a "too many parameters" error on large stores #887

  • Fix a crash on the first request after an unattended upgrade #888

  • Fix a SQLite migration failure when upgrading a store with existing customer data #889

  • Fix discount rule and reward provider setting descriptions not showing in the backoffice #890

  • Fix the Variants tab not appearing when the Variants Editor property is inherited through a Content Type Composition #891

17.2.3 (21st Aug 2026)

  • Fix a startup crash on large stores during the customer data migration #883

  • Fix cart cleanup failing with a foreign key constraint error on large stores #882

  • Fix payment provider callback URLs trusting a spoofable X-Original-Host header

17.2.2 (17th Aug 2026)

  • Fix a backoffice crash when viewing an order linked to a customer by member key or another non-ID reference #878

  • Fix data corruption from a discount migration that could invalidate member-group discount rules #877

  • Fix missing database indexes causing slow order and order line deletes on large stores #879

  • Fix missing price fields in the dynamic shipping rate range editor #880

17.2.0 (12th Aug 2026)

  • Add customer management, including customer records, addresses, communication history, and statistics that sync automatically from orders

  • Add support for editing an order after it has been finalized and authorized, including changing line quantities, adding or removing lines, and reconciling discount and gift card codes

  • Add partial capture support for payment providers, with the authorized and captured amount both shown in the transaction history

  • Fix a database migration failure when importing customer records from legacy orders that have no first or last name #876

17.1.12 (11th Aug 2026)

  • Fix email rendering crash when there's no active HTTP request #872

  • Fix cart cleanup timing out on stores with a large number of old carts #874

17.1.11 (7th Aug 2026)

  • Fix the Commerce section failing to load on CMS 17.6.0 #868

17.1.9 (29th Jul 2026)

  • Add logging to record why an order is moved to the error status, and when a payment is reset or redirected through a payment provider's cancel or error URL #866

17.1.8 (27th Jul 2026)

  • Fix a second order save being triggered while frozen prices were recalculating, which could cause a concurrency error

  • Improve logging when an order calculation fails, so the underlying cause and order details are recorded

  • Fix the cart becoming unusable when an order line's product can no longer be found #863

  • Fix creating a product picker Data Type failing with a "property editor not found" error

  • Fix product attribute and preset changes requiring the Settings section instead of the Commerce section

17.1.7 (15th Jul 2026)

  • Fix cart conversion "Reached Checkout" and "Purchased" totals drifting for past periods #835

  • Fix the product picker in the discount rule editor losing store context

  • Tolerate legacy member group names in discount rule settings #839

  • Raise CartAbandonedNotification from the abandoned cart pipeline #805

  • Guard against a null content node in StockPropertyValueConverter #848

  • Fix a crash in the variant picker when a variant has no price #829

  • Fix a NULL dateTimeUtc error in the transaction activity migration #831

  • Preserve the original stack trace on errors surfaced by PollyExecutionStrategyBase #815

  • Fix DateTime settings failing to parse space-separated values

  • Reset (rather than cancel) the transaction when a customer abandons checkout #789

  • Fix order transaction, export authorization, and top-buyers analytics bugs

  • Use the CMS scope in StoreTelemetryRepository to avoid querying CMS tables against the Commerce database

17.1.6 (8th Jul 2026)

  • Fix a false-positive "transaction amount changed" exception in BeginPaymentFormAsync

  • Fix a NullReferenceException when using dynamic shipping with no product measurements or no store location

  • Fix a NullReferenceException when a dynamic shipping rate range provider alias cannot be resolved

17.1.5 (28th May 2026)

  • Fix payment form generation throwing "Order has changed and needs recalculating" exception when a customer is auto-assigned on payment start #832

  • Preserve an existing customer reference on the order when a member logs in (only auto-assign when no reference is set)

  • Surface OrderCalculation on ShippingProviderContext so realtime shipping providers can read in-progress totals during recalc #850

  • Fix store dashboard order counts and revenue not matching the Analytics page #840

17.1.4 (14th May 2026)

  • Added search notifications events for orders, carts and gift cards #824, #827

17.1.3 (26th Feb 2026)

  • Make DiscountRuleContext and DiscountRewardContext constructors public for custom DiscountsPriceAdjuster implementations

  • Fix transaction fee not being tracked on AuthorizeTransactionActivity

17.1.2 (19th Feb 2026)

  • Updated the hashing depth of the realtime shipping rates calculator

  • Fixed passing transaction fee on payment authorisation

  • Add searching to Gift Cards #765

  • Enable cachebusting for backoffice JavaScript assets #793

  • Fix shipping and payment buttons in Cart order details #820

  • Fix order CSV export #822

17.1.1 (29th Jan 2026)

  • Allow decimal input for percentage property editor #817

  • Make CompactSortableOrderNumberGenerator and INodeIdAccessor public #819

17.1.0 (22nd Jan 2026)

  • 17.1.0 stable release

17.1.0-rc1 (8th Jan 2026)

  • Implemented new order caching layer with version based expiry for better load balancing support.

  • Added support for a refund reason when refunding an order.

  • Added Refund Rate analytics widget.

  • Added Top 50 Buyers analytics widget.

  • Added Low Stock analytics widget.

  • Added browser titles to workspaces.

  • Added UFM view template support to editable model properties.

  • Fixed print templates not rendering if you don't have Settings section permission.

  • Fixed variants content endpoints not returning data.

17.0.0 (27th Nov 2025)

  • Version 17 final release.

17.0.0-rc1 (04th Nov 2025)

Initial release candidate for Umbraco v17. This release doesn't contain any new features; rather, it's a v17 compatibility release.

  • Updated to Umbraco CMS v17.

  • Upgraded all third-party dependencies.

  • Removed all obsolete code flagged for removal in v17.

PreviousLegacy Documentation
NextCommerce Packages

Last updated

Was this helpful?