Dynamics 365 Commerce component versioning requirements

Article
08/12/2022
3 minutes to read

This article provides an overview of the component versioning requirements and dependencies for all components in the Microsoft Dynamics 365 Commerce ecosystem.

The following illustration shows an overview of Dynamics 365 Commerce components and corresponding versioning requirements and dependencies.

Component dependencies

Service updates

To ensure compatibility between all Commerce components that are serviced and deployed by customers and partners, you must follow several versioning dependencies during servicing updates. The following list describes all these dependencies.

Commerce headquarters and finance and operations apps must be on the same version as, or a newer version than, Commerce Scale Unit (both cloud and self-hosted).

For example, if Commerce headquarters and finance and operations apps are on version 10.0.27, Commerce Scale Unit must be on version 10.0.27 or earlier (for example, 10.0.26 or 10.0.25).
Commerce Scale Unit must be on the same version as, or a newer version than, Modern Point of Sale (POS), Hardware Station, and the Commerce software development kit (SDK) and associated local site configurations (such as modules, data actions, and themes).

For example, if Commerce Scale Unit is on version 10.0.27, Modern POS, Hardware Station, and the Commerce storefront must be on version 10.0.27 or earlier (for example, 10.0.26 or 10.0.25).
Extension packages must be compiled against the same version as, or a newer version than, the target component that the extension applies to.

For example, if the deployed Commerce Scale Unit is on version 10.0.27, the corresponding extension packages must be compiled against version 10.0.27 or earlier (for example, 10.0.26 or 10.0.25).

Quality updates

During quality updates, no specific versioning requirements must be followed for each Commerce component, besides what is required for service updates.

Current supported versions

The following table describes the current supported versions of various Commerce components as of July 18th, 2022.

Component	Latest available release (first release available in Sandbox)	Latest available component version number (first release available in Sandbox)	Earliest supported release	Earliest supported component version number
Finance and operations apps	10.0.27	10.0.27	10.0.23	10.0.23
Commerce Scale Unit (cloud-hosted)	10.0.27	9.37	10.0.23	9.33
Commerce module library	10.0.27	9.37	10.0.23	9.33
Commerce Scale Unit (self-hosted)	10.0.27	9.37	10.0.19	9.29
Modern POS	10.0.27	9.37	10.0.19	9.29
Hardware Station	10.0.27	9.37	10.0.19	9.29

One Version requirements

Commerce components follow the One Version service updates. For more information, see One Version service updates FAQ.

Cloud components

Customers can pause up to three consecutive updates across the following components. (Three updates correspond to approximately six calendar months.)

Commerce headquarters and finance and operations apps
Commerce Scale Unit (cloud-hosted)
Commerce SDK and associated local site configurations (such as modules, data actions, and themes)

For example, customers who are currently on version 10.0.24 can pause updates to versions 10.0.25, 10.0.26, and 10.0.27. However, they must then update to version 10.0.28. In this scenario, after version 10.0.29 becomes available, version 10.0.24 is no longer supported.

In-store components

Customers can pause up to seven consecutive updates across the following components:

Commerce Scale Unit (self-hosted)
Modern POS or Store Commerce
Hardware station

For example, customers who are currently on version 10.0.24 can pause updates for the released versions 10.0.25, 10.0.26, 10.0.27, 10.0.28, 10.0.29, 10.0.30 and 10.0.31. However, they must then update to version 10.0.32. In this scenario, after version 10.0.32 becomes available, version 10.0.24 is no longer supported.

Additional resources

Component selection

For more information about how to select the correct components to meet your needs, see the following articles:

Servicing instructions

For more information about how to service individual components that are described in this article, see the following articles:

Extensibility and packing

For more information about serviceability for extensions, see Create deployable packages.

Help us understand

We want to learn more about how people use Microsoft's custom Help toolkit. Take the survey (in English) and help us understand: https://forms.office.com/r/A4cUJgjkD1.