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.
Any breaking changes or important issues to consider when upgrading are also mentioned in this article.
If you are upgrading to a new major version, check the breaking changes in the Version Specific Upgrade Notes article.
This section contains the release notes for Umbraco Commerce 14 including all changes for this version.
Added telemetry support as detailed here.
Added a cart-to-order feature that will facilitate admin users to finalize an order directly from the BackOffice cart workspace.
Fixed Rounding issue between Umbraco Commerce and Stripe payment gateway #580.
Important If you are running on version 14 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.
Fixed Exception on GetOrCreateCurrentOrder in SessionManager #581.
Fixed bug in group discounts provider based on the issue described in #574.
Fixed UDI parsing error when using product related discount rules due to missing UDI Json Converter. Fixed by backporting PocoFactory from v15.
Fixed regression in EntityCache updates from 13.1.7/13.1.8 failing under load #573.
Fixed bug in Order search API throwing ORDER BY clause exception #571.
Fixed bug in Country create dialog failing if Regions exist within another store instance #568.
Fixed Price Adjustments applied to bundle sub order line not reflected in the bundle unit price #564.
Belt and brace updates to EntityCache and added a logger to log if an attempt is made to set a NULL key #565.
Fixed issue where the EntityCache fail after the .NET Software Development Kit (SDK) update #565.
Fixed issue with malformed SQL Server migration (#561).
Added Sales Tax Provider support.
Added Tax Calculation Method to allow for calculated tax rates.
Updated Countries to accept a tax calculation method.
Updated Tax Classes to support tax codes.
Fixed broken migration causing exception on upgrade.
Fixed issue where price inputs wouldn't allow an explicit 0.00 value for free products (#555)
Read the v14.0.0 release post for more information about this release.
Added "No results" messages to collection views
Upgraded Umbraco CMS dependency to v14.2.0
Added warning on store dashboard/analytics section if the store has multiple currencies when no currency exchange rate service is configured.
Added nullable type support to payment provider/shipping provider settings models.
Added UcStoreContext to exported NPM package.
Added background task licenses resolver to allow Umbraco Commerce to run background tasks without error.
Added delete support to carts and orders.
Updated store create dialog to redirect to store editor on create.
Fixed error on store dashboard when using SQL Server due to group by issue in SQL statement #547.
Fixed errors in v14 migrations when using a separate table for Umbraco Commerce.
Fixed error in v14 migrations where data types are not correctly migrated.
Fixed store tree not updating when a new store is created.
Fixed shipping provider advanced settings now showing in an advanced dropdown editor UI.
Fixed broken localization keys.
Fixed issue in rc1 DB migration script.
Added sort modals to all sortable entities.
Added basic text search across all entity collection views.
Added cart status filter option to carts collection view.
Added advanced properties support to payment/shipping provider settings.
Added order activity log funcationality back in.
Added commerce section dashboard.
Added async pipeline implementation.
Added front end NPM package for UI extension points.
Localized all hard coded strings.
Replaced Newtonsoft.Json with System.Text.Json throughout.
Removed ExchangeRateHost as the default exchange rate service as it now requires an API key.
Fixed validation error for Region code not matching the description example.
Fixed bug in payment provider URL generation containing a rogue $ symbol.
Added Product Attributes section
Added Product Attribute Presets section
Added Variants property editor to create complex product variants
Fixed issues with property editor value converters
Fixed issue with stock synchronization
Added Carts section with ability to create/edit customer carts
Refactored order endpoints to use a defined model for customer/billing/shipping details rather than using order properties collection
Merged in v13 bug fixes
Added Analytics section
Added Create Country modal to allow creating countries from ISO 3166 presets
Added license warning component throughout the commerce section
Updated Regions workspace app to now be hidden until the country is persisted
Update Payment Provider / Shipping Provider label keys to convert kebab case provider aliases to camel case keys for consistency
Fixed bug in Payment Providers section throwing error due to unmapped sku property
Fixed issue due to use of JSON_PATH_EXISTS in migration scripts only supported in SQL Server 2022+. Resorted to just using JSON_VALUE queries instead (#521)
Added section condition to commerce section to only show it when the current user has permission to see it
Setup Management APIs for Product Attributes, Discounts, Gift Cards and Analytics sections
Created an new Umbraco Commerce Payment API to handle payment gateway interactions (old endpoints are depricated)
Added a basic store dashboard with current days stats and order search
Added Gift Cards section
Added Discounts section
Various bug fixes
Backoffice resources are now lazy loaded
Upgraded Umbraco dependency to v14 final
Read the v14.0.0-Alpha release post for further background on this release.
v14 initial alpha release
You can find the release notes for Vendr in the Change log file on Github.
Umbraco Commerce v14.0.0 release notes.
This release marks the v14 build of Umbraco Commerce, now feature complete and ready for developers to start using it.
build with web-components.
Some to be expected.
New more flexible added.
New added.
support added (in progress).
As with everything v14, this is a complete rebuild of the backoffice UI using web components. This ensures Umbraco Commerce is set for the future and creates a solid foundation to develop new features and functionality.
With the new backoffice UI, there has inevitably been the need to change some functionalities, and as such breaking changes could not be avoided. These have tried to be minimized as much as possible, whilst also ensuring we embrace the new front-end architecture to its fullest.
The key breaking changes to expect are:
UI Config Files Removed
In addition to this, the UI config files were also used in the backoffice to extract key order properties. For example, extracting the shipping address to calculate shipping rates. This functionality has now been split, and the mapping functionality has been moved to a new server-based configuration API.
Web Notification Events Removed
The following notifications are no longer being fired:
AnalyticsDashboardConfigParsingNotification
CartEditorConfigParsingNotification
OrderEditorConfigParsingNotification
StoreActionsRenderingNotification
ActivityLogEntriesRenderingNotification
Web Controllers/Models Removed
With the new Management API, any controllers or models previously located in Umbraco.Commerce.Cms.Web have been removed. Please use the Management API instead.
The only exception to this rule is the PaymentController, which serves as a callback for payment gateways. It is currently located at the same URL to avoid disrupting existing transaction communications. However, all new integrations should communicate with a new Payments API.
With the new backoffice comes a new extensions system for the UI, and we have tried to maximize its use. This means converting the old UI configs system to use the new manifests system.
With the new extension points it is possible to:
Change the properties used by the order editor.
Add properties to the order line properties editor.
Add properties to the Notes, Additional Info, and Customer Details modals.
Add properties to the order collection view.
Add analytics widgets (still in progress)
Define custom views for properties to control value rendering.
Here is an example of how you would configure these properties:
With these extension points, the Umbraco Commerce order editor is now more flexible than it has ever been before.
We are yet to launch an Umbraco Commerce NPM module, so these functionalities are not currently available for external use. However, we wanted to give you a heads-up about what is coming so you can prepare.
With the new UI, a new API layer is also introduced, similar to the CMS.
With the Umbraco Commerce API, we have aimed to keep it aligned with the Storefront API with support for filtering and expansion where possible.
We developed this API for external developers who can use it to create different UIs for Umbraco Commerce, such as a dedicated mobile app. We have made sure that there are no "special" endpoints exclusively for the Umbraco CMS UI.
Given the fresh start, we made sure that everything we built fully supports localization, so this will be included in this release.
In this update, we have made some changes to payment and shipping providers, as well as other CSharp extension points where properties are defined. These changes mean that labels and descriptions will no longer be hard-coded; instead, the values will be looked up from the localization file.
Umbraco Commerce v14.0.0-Alpha release notes.
Umbraco Commerce v14.0.0-Alpha is the initial release of Umbraco Commerce for Umbraco CMS v14. Being an alpha, this is an early preview of the Umbraco Commerce product and as such should be considered a work in progress.
Contains for store setup, order management and key property editors.
Some .
Some to be expected.
Brand new .
New more flexible added.
support added (in progress).
The key focus of this alpha release is to provide the core functionality required to be able to setup and run a store in Umbraco Commerce allowing users to get started on v14 right away.
The key features included in this release are:
Store Creation / Editing
Location Creation / Editing
Order Status Creation / Editing
Payment Method Creation / Editing
Shipping Method Creation / Editing
Country & Region Creation / Editing
Currency Creation / Editing
Tax Class Creation / Editing
Email Template Creation / Editing
Print Template Creation / Editing
Export Template Creation / Editing
Order View / Editing
Order / Order Line Properties Editing
Within these sections there are some known missing features:
Missing text filtering on collection views
Missing bulk operations implementation
Missing sort functionality
Missing advanced order searching
Missing order filter menus
In addition to these, there are also some complete sections currently outstanding:
Store overview dashboard
Cart section
Discounts section
Gift cards section
Analytics section
Product Attributes + Product Attribute Presets section
Lastly, there is also some property editors still yet to implement:
Variants
Needless to say, these will all be implemented for the final v14 release, but in order to get a usable Umbraco Commerce product into your hands as quickly as possible, these features / sections were put at lower priorities at this stage of the conversion.
With the new backoffice UI, there has inevitably been the need to change some functionalities and use such breaking changes couldn't be avoided. These have tried to be minimized as much as possible, whilst also ensuring we embrace the new front end architecture to it's fullest.
The key breaking changes to expect are:
UI Config Files Remove
In addition to this, the UI Config Files were also used in the backoffice to extract key order properties for things like extracting the shipping address in order to calculate shipping rates. This functionality has now been split such that this mapping functionality has now moved to a new server based configuration API.
Web Notification Events Removed
The following notifications are no longer being fired.
AnalyticsDashboardConfigParsingNotification
CartEditorConfigParsingNotification
OrderEditorConfigParsingNotification
StoreActionsRenderingNotification
ActivityLogEntriesRenderingNotification
Web Controllers / Models Removed
With the new Management API this does mean any controllers / models that previously lived in the Umbraco.Commerce.Cms.Web will now have been removed. Please use the Management API instead.
The only exception to this is the PaymentController which is used as a callback for payment gateways. This is currently kept at the same URL to prevent breakages. We will be reviewing this to see if some other endpoint location makes more sense.
With the new backoffice comes a new extensions system for the UI and we have tried to use this to the maximum. These means converting the old UI configs system to using the new manifests system.
With the new extension points it is possible to:
Change the properties used by the order editor.
Add properties to the order line properties editor.
Add properties to the Notes, Additional Info and Customer Details modals.
Add properties to the order collection view.
Add analytics widgets (still in progress)
Define custom views for properties to control value rendering.
Here is an example of how you would configure such properties
With these extension points, the Umbraco Commerce order editor is now more flexible than it has ever been before.
We are yet to launch an Umbraco Commerce NPM module so these points are not yet currently available to use externally but we wanted to give you a heads up of what is coming so you can prepare.
As with the CMS, with the new UI comes a whole new API layer.
With the Umbraco Commerce API we have aimed to keep it aligned with the Storefront API with support for filtering an expansion where possible.
I key thought whilst developing this API has been to ensure external developers might use this to build other UI's for Umbraco Commerce such as a dedicated mobile app and so we've tried to ensure there are no "special" endpoints just for the Umbraco CMS UI.
One of the things that has been on the Umbraco Commerce TODO list for a while is to add backoffice localization support. Given the fresh start it was only logical that we take the time to ensure that everything we built fully supported localization so this will be included in this release.
We haven't quite caught everything yet, but we'll be sure to do a full check before the final release to ensure all hard coded strings are fully configurable.
With this update, we'll also be making some changes to things like payment and shipping providers, and other CSharp extension points where we define properties. These will no longer require hard coded labels / descriptions and instead will look these values up from the localization file.
We are still yet to tackle adding v14 support to the Umbraco.Commerce.Deploy and Umbraco.Commerce.Checkout add-ons so these are currently unavailable. These will likely be made available after the initial v14 release.
We would welcome feedback on any installation / upgrade issues along with bugs found in any of the completed sections as detailed above.
Previously, in Umbraco Commerce, it was possible to configure the backoffice order list view, order editor, and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. For more details, see the section below.
In previous versions of Umbraco Commerce it was possible to configure the back office order list view, order editor and analytics dashboards using JSON UI config files. These have now all been updated to use the new manifests pattern in Umbraco v14. See the section bellow for more details.
Issues can be raised on the Umbraco Commerce issue tracker at .
