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 16 including all changes for this version.

16.4.0-RC (Oct 15th 2025)

  • Added compact sortable order number generator to generate shorter order numbers (new installs only).

  • Added product adapter discount rules to allow product/category-based discounts for non-Umbraco-based products.

  • Added validation attribute support to Payment/Shipping method custom settings.

  • Updated backoffice to display order/cart prices inclusive of sales tax when the store's "Prices include tax" toggle is enabled.

16.3.2 (Oct 15th 2025)

  • Fixed discount rule provider settings not showing the correct description #772.

  • Fixed legacy PaymentMethod.ToggleFeaturesAsync method redirecting to a replacement that had internal setters #761.

  • Fixed an issue with the shipping provider create dialog failing to redirect when non-lowercase characters are used.

16.3.1 (Sep 25th 2025)

  • Fixed inconsistency between Payment and Shipping Methods SetEnabledAsync API.

  • Fixed issue with product related discounts not applying correctly #758.

  • Fixed shipping address summary showing the billing address country #756.

  • Fixed slow order list load times by adding page size pagination selector and defaulting to 25 rather than 100 #755.

16.3.0 (Sep 10th 2025)

  • Added ability to disable payment/shipping providers without losing data #659.

  • Added a country discount rule #656.

  • Added processing and failed states to carts to be able to identify carts having payment processing difficulties #664.

  • Added frozen prices cache refresher to ensure frozen prices invalid in load balanced environments #649.

  • Updated the HasOrderLineWithProduct query specification to support a StringComparisonType #660.

  • Fixed inability to unset a payment/shipping method via the Storefront API #752.

  • Fixed inability to unset custom properties via backoffice #750.

  • Fixed issue with stock synchronization logic ignoring the stock property editors store configuration #741.

  • Fixed issue with carts list view not calling back to the manifest entries label #749.

  • Fixed issue with backoffice not allowing the adding of products to cart with an explicit '0' price value #747.

  • Fixed issue with notes text areas trimming whitespace between keystrokes #746.

  • Fixed exception thrown when a store's "Use Cookies" setting was disabled #745.

  • Fixed an OrderLines naming inconsistency in payment refunds API #742.

16.2.2 (Aug 14th 2025)

  • Fixed a rounding issue in order calculations #744.

  • Fixed issue when using MultipleTextstring as property editor for provider setting resulting in malformed data #743.

  • Fixed issue with date formatting / parsing due to server culture differences #738.

16.2.1 (29th Jul 2025)

  • Fixed regression in 16.2.0 not containing updates from 16.1.1.

16.2.0 (29th Jul 2025)

  • Added TryCalculatePriceWithAdjustmentsAsync methods to allow calculating product prices with discounts up-front.

  • Added Email Template Testing feature to allow testing email templates directly from the backoffice.

16.1.1 (18th Jul 2025)

  • Updated order/orderline property label fallback behaviour to be constant in all usages #733.

  • Fixed location picker value being null in models builder model #726.

  • Fixed discount editor resetting start/end dates due to UTC data format mishandling #728.

  • Fixed issue where the product picker breaks when a product has no price defined #730.

  • Fixed issue when using MultipleTextstring as property editor for provider setting resulting in malformed data #734.

  • Fixed error in StorefrontAPI when trying to expand shipping/payment method models #736.

  • Fixed issue with StorefrontAPI displaying the payment method pricing for the shipping method #736.

  • Fixed issue with amount based discount rules not persisting decimal values.

16.1.0 (11th Jul 2025)

  • Added store theming options to store settings.

  • Added abandoned cart notifier service to send emails & webhooks when carts become abandoned.

  • Fixed regression with not being able to refund a payment #710.

  • Fixed bug in Safari browsers not persisting price property updates #713.

  • Fixed bug with gift cards not persisting remaining amount #729.

16.0.0 (12th Jun 2025)

  • Version 16 final release.

  • Fixed bug in property editors with store config not resolving the correct store #721.

  • Fixed stock input allowing stock levels below zero #714.

  • Fixed bug in price property editor not honoring extra decimal places config #712.

16.0.0-rc1 (28th May 2025)

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

  • Updated to Umbraco CMS v16.

  • Upgraded all third-party dependencies.

  • Removed all obsolete code flagged for removal in v16.

Last updated

Was this helpful?