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

12.1.10 (April 23rd 2024)

• Fixed error in SearchOrder when searching with date ranges #496.

12.1.9 (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 12.1.8) #472.

• Added support for localhost sub domains in dev license #493.

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

12.1.8 (March 27th 2024)

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

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

12.1.7 (March 3rd 2024)

• Fixed issue with date range order searches not working correctly #468.

12.1.6 (February 15th 2024)

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

• Incremented Newtonsoft.Json version dependency to 13.0.1 as 13.0.0 doesn't exist on NuGet anymore #451.

12.1.5 (February 6th 2024)

• 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

12.1.4 (December 13th 2023)

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

12.1.3 (November 1st 2023)

• Use Microsoft.Data.SqlClient for migrations to support Azure connection strings #443.

• Move system config files to system.{}.config.json to allow overriding as per the docs #448.

• Updated order/cart editor config to allow template option for custom property rendering #446.

12.1.2 (October 18th 2023)

• Fixed UI spelling mistakes as documented in issue #427.

• Fixed issue where adding a product with a uniqueness property, and then adding the same product without a uniqueness property would replace the initial orderline, rather than adding a new one #438

• Fixed localization issue where -1 in querystrings would get incorrectly formatted. Root ids are now formatted with an invarient culture.

12.1.1 (September 13th 2023)

• Fixed issue with Storefront API causing value converter error due to multiple value converts for the same property editor being found. Storefront API value converters are now no longer discoverable. They are instead registered only when AddStorefrontApi is called on the IUmbracoCommerceBuilder instance #429

12.1.0 (August 30th 2023)

• All items listed under 12.1.0-rc1.

• Updated Umbraco.Commerce package to have dependency on Umbraco.Commerce.Cms.Web.Api.Storefront so that an explicit dependency isn't needed.

• Allow overriding of SameSite/Path for Umbraco Commerce cookies.

• Updated product adapter to resolve product details correctly from child node variants.

12.1.0-rc1 (August 15th 2023)

• Added headless Storefont API.

• Added templating functionality to payment provider settings to allow dynamic value resolution. For example the template {Order.OrderNumber} would inject the order number into the given setting value.

• Added IProductSnapshotWithImage interface to allow product snapshots to expose a product image.

• Updated default order number template from CART-{0} to ORDER-{0}.

• Updated product adapter to resolve product details correctly from child node variants.

12.0.0 (July 5th 2023)

• Initial product launch.

Legacy release notes

You can find the release notes for Vendr in the Change log file on Github.