Umbraco Commerce
CMSCloudHeartcoreDXP
13.latest (LTS)
13.latest (LTS)
  • Umbraco Commerce Documentation
  • Release Notes
    • v13.1.0-RC
  • Commerce Products
    • Commerce Packages
    • Commerce Payment Providers
    • Commerce Shipping Providers
  • Installation
    • Installing Umbraco Commerce
    • Licensing
  • Upgrading
    • Upgrading Umbraco Commerce
    • Version Specific Upgrade Notes
    • Migrate from Vendr to Umbraco Commerce
      • Migrate Umbraco Commerce Checkout
      • Migrate custom Payment Providers
  • Getting Started
    • Introduction
    • Umbraco Configuration
    • User Interface
  • How-To Guides
    • Overview
    • Configure SQLite support
    • Limit Order Line Quantity
    • Use an Alternative Database for Umbraco Commerce Tables
    • Add item to Cart
    • Update Cart
    • Delete item in Cart
    • Customizing Templates
  • Key Concepts
    • Get to know the main features
    • Base Currency
    • Bulk Actions
    • Calculators
    • Dependency Injection
    • Discount Rules / Rewards
    • Events
      • List of validation events
      • List of notification events
    • Fluent API
    • Order Calculation State
    • Payment Forms
    • Payment Providers
    • Pipelines
    • Price/Amount Adjustments
    • Price Freezing
    • Product Adapters
    • Product Bundles
    • Product Variants
      • Complex Variants
    • Properties
    • ReadOnly and Writable Entities
    • Search Specifications
    • Settings Objects
    • Shipping Package Factories
    • Shipping Providers
    • Shipping Range/Rate Providers
    • Tax Sources
    • UI Config Files
    • Umbraco Properties
    • Unit of Work
    • Umbraco Commerce Builder
    • Webhooks
  • Tutorials
    • Overview
  • Reference
    • Stores
    • Shipping
      • Fixed Rate Shipping
      • Dynamic Rate Shipping
      • Realtime Rate Shipping
    • Storefront API
      • Endpoints
        • Order
        • Checkout
        • Product
        • Customer
        • Store
        • Currency
        • Country
        • Payment method
        • Shipping method
        • Content
    • Go behind the scenes
Powered by GitBook
On this page
  • Release History
  • Legacy release notes

Was this helpful?

Edit on GitHub
Export as PDF

Release Notes

Get an overview of the changes and fixes in each version of Umbraco Commerce.

PreviousUmbraco Commerce DocumentationNextv13.1.0-RC

Last updated 10 days ago

Was this helpful?

In this section, we have summarized the changes to Umbraco Commerce that were released in each version. Each version has a link to the 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 article.

Release History

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

(Mar 31st 2025)

  • Fixed an issue in the previous migration that increased the monetary column precision .

(Mar 3rd 2025)

  • Updated Umbraco.Licenses dependency to fix issue with license resolution in Azure environments.

  • Fixed custom headers missing from display in carts list .

  • Fixed the OrderHasCustomerEmailAddress query specification performing the wrong comparison (essentially inverted).

  • Fixed issue where a recalculation of an order with a shipping method that no longer meets it's eligability criteria rolls back the Unit of Work even if the failure can be automatically rectified.

(Feb 19th 2025)

  • Fixed regression from 13.1.18 where a Unit of Work was not populating the ambient reference when using uow.Create .

  • Fixed bug in commerce section dashboard showing the wrong order total value + order total count .

  • Fixed bug in "Placed On Order After / Before" advanced filters UI loosing the selected dates when re-opening modal .

  • Fixed bug that deleting a country would throw exception .

  • Fixed bug where deleting a region didn't update Shipping / Payment Method allowed country regions .

  • Fixed bug where error is thrown if saving a shipping / payment method without an SKU by adding client side required field validation .

  • Fixed bug with applyToCurrentOrder not applying changes to default currency .

  • Fixed bug where changing a gift card code alias would cause error for orders using that gift card .

  • Added code to retry requests that result in a DBConcurrencyException.

13.1.18 (February 11th 2025)

  • Fixed issue with shipping / payment calculators executing for order with zero line items.

  • Fixed issue in unit of work causing child units of work to run their own retry policy. Now limited to only the outer unit of work that executes one.

13.1.16 (January 13th 2025)

  • Updated Umbraco.Licenses dependency with latest changes.

13.1.15 (January 8th 2025)

  • Fixed issue with inconsistent payment validation incorrectly identifying some payments as inconsistent.

13.1.14 (December 12th 2024)

  • Added support for test licenses.

Important If you are running on version 13 of Umbraco Commerce it is advised to upgrade to this version as soon as possible. Changes in .NET 8.0.8 cause an error in our EntityCache which have been resolved in this release. With some hosting providers automatically applying .NET patch releases, upgrading should be proritised to avoid any unintentional breakages.

  • Check the config for being undefined in order's edit properties dialog.

  • Updated pessimistic locking on the payment provider callback endpoints to lock from the start of the request, not when processing the callback.

  • Fixed issue where order lines with a zero value would cause a concurrency exception due to the fact their prices aren't frozen but the order recalculation process was attempting to refreeze them.

  • Fixed error with realtime shipping rates provider where the rate cache duration was zero.

  • Updated MemoryCache usages to fallback to a default implementation if one isn't found in the DI container.

  • Added a WithUmbracoBuilder extension for IUmbracoCommerceBuilder to allow access to the Umbraco configuration within an Umbraco Commerce registration.

  • Fixed Order.ProductVariantReference mapping to the wrong field in Storefront API.

  • Fixed CountryRegionTaxRate.Country mapping to the wrong field in Storefront API.

13.1.0 (February 21st 2024)

  • Minor release closing off the RC period.

  • Fixed null exceptions when creating shipping methods with empty config.

  • Added helper methods to FixedRateShippingCalculationConfig to make it's API closer to the older fixed rate price lookup API.

13.1.0-rc3 (February 15th 2024)

  • Fixed missing SQL Server migrations.

  • Fixed realtime shipping rates cache not taking shipping country/region changes into account.

  • Fixed realtime shipping rates cache not taking store default location changes into account.

  • Updated Umbraco.Licenses version dependency to the latest.

  • Made WithUmbracoCommerceBuilder extension public to allow accessing the IUmbracoCommerceBuilder instance outside of the AddUmbracoCommerce call.

13.1.0-rc2 (February 8th 2024)

  • Fixed RC1 regression where discount/gift card tree icons were broken.

  • Fixed RC1 regression where localized translations were broken.

  • Fixed issue in dynamic shipping subtotal range provider not taking the current calculation context into account and so was selecting the wrong range.

13.1.0-rc1 (February 6th 2024)

  • Adds dynamic shipping rate calculation option.

  • Adds real-time shipping rate calculation option via Shipping Providers.

  • Adds store locations for shipping calculations.

  • Adds store Measurement System setting.

  • Adds Measurements property editor for capturing product measurements for shipping calculations.

  • Adds shipping package factory concept for calculating packages for shipments.

  • Updates the shipping method create-flow to require selecting a shipping provider and a shipping calculation mode.

  • Updates API for calculating shipping prices as payment methods can now return multiple rates.

  • Updates the order API for setting the shipping method to accept a ShippingOption for shipping methods that can supply multiple rates.

  • Updates the order editor to display the selected shipping option.

  • Updates the cart editor to allow selecting a shipping option from real-time shipping methods.

  • Updates the cart editor to calculate shipping rates/payment fees based on the current in-memory cart state.

  • Updates storefront API to incorporate new shipping rates endpoints.

13.0.2 (February 15th 2024)

13.0.1 (February 6th 2024)

  • Reset request stream before passing to payment providers.

  • Added licensing fallback to use any previously validated license within the last 7 days.

  • Updated Umbraco.Licenses version dependency to the latest.

  • Made WithUmbracoCommerceBuilder extension public to allow accessing the IUmbracoCommerceBuilder instance outside of the AddUmbracoCommerce call.

  • Upgraded to run again Umbraco v13 and .NET 8

  • Upgraded all 3rd party dependencies

  • Fixed Cross-site scripting (XSS) issue in email/print templates

Legacy release notes

(January 28th 2025)

Fixed issue with stock cache refresher no refreshing due to incorrect cache key .

(November 11th 2024)

Fixed Rounding issue between Umbraco Commerce and Stripe payment gateway .

(November 1st 2024)

Fixed Exception on GetOrCreateCurrentOrder in SessionManager .

(October 25th 2024)

Fixed regressions due to updates from 13.1.6 not getting merged back into main project .

Fixed bug in group discounts provider based on the issue described in .

(October 23rd 2024)

Fixed regression in bug fix for preventing order details being returned from search queries .

(October 23rd 2024)

Fixed regression in EntityCache updates from 13.1.7/13.1.8 failing under load .

Fixed bug in Order search API throwing ORDER BY clause exception .

Fixed bug in Country create dialog failing if Regions exist within another store instance .

Fixed Price Adjustments applied to bundle sub order line not reflected in the bundle unit price .

(October 17th 2024)

Belt and brace updates to EntityCache and added a logger to log if an attempt is made to set a NULL key .

(October 10th 2024)

Fixed issue where the EntityCache fail after the .NET Software Development Kit (SDK) update .

(July 11th 2024)

Fixed issue with the Storefront API hosted checkout not rendering form attributes .

Fixed issue with 13.1.5 migration scripts using too new a feature .

Fixed issue with stock synchronizer prematurely looking up a store .

(July 3rd 2024)

Added new IRoundingService to allow overriding the default rounding behavior .

Added pessimistic locking to the payment provider callback endpoint to prevent concurrency issues if the endpoint is called too many times at once .

Fixed issue with malformed script tags in the Storefront API hosted checkout pay endpoint .

Fixed percentage discounts not taking the stores rounding method into account during calculation .

Updated Order properties to trim whitespace around values to prevent unexpected behavior .

Updated all currency database tables to support 8 decimal places to prevent rounding issues with order quantities above 1000 .

(April 23rd 2024)

Fixed error in SearchOrder when searching with date ranges .

(April 8th 2024)

Fixed properties set in the background from an entity action lost when resaving the entity from the UI after the action (wasn't fully fixed in 13.1.2) .

Fixed orderline properties not showing in orderline summary by default due to regression from strongly typing UI config files in 13.1.0 .

Added support for localhost sub domains in dev license .

(March 27th 2024)

Fixed properties set in the background from an entity action lost when resaving the entity from the UI after the action .

Fixed unable to override cart editor view like you can the order editor view .

Fixed regression where launching the shipping method country prices dialog caused JavaScript errors .

Fixed regression with order list configs not deserializing correctly .

Added better validation error messages when saving locations missing required fields .

(March 3rd 2024)

Fixed regression where custom order/cart editor view stopped working .

Fixed issue with Locations not deleting .

Fixed issue with date range order searches not working correctly .

Fixed error in SafeLazy not taking null into account and so causing errors when an entity cache entry is evicted .

Read the for further background on this release.

Fixed error in SafeLazy not taking null into account and so causing errors when an entity cache entry is evicted .

(December 13th 2023)

You can find the release notes for Vendr in the .

Commerce issue tracker
Version Specific Upgrade Notes
13.2.1
#681
13.2.0
#672
13.1.19
#670
#601
#515
#477
#669
#384
#278
#149
13.1.17
#612
13.1.13
#580
13.1.12
#581
13.1.11
#576
#574
13.1.10
#571
#575
13.1.9
#573
#571
#568
#564
13.1.8
#565
13.1.7
#565
13.1.6
#532
#539
#536
13.1.5
#506
#533
#532
#506
#528
#506
13.1.4
#496
13.1.3
#472
#494
#493
13.1.2
#472
#474
#480
#485
#481
13.1.1
#469
#470
#468
#466
v13.1.0-RC release post
#466
13.0.0
Change log file on GitHub