Apply updates and extensions to Commerce Scale Unit (cloud)

If you are updating a Tier-2 sandbox or production environment on application version 8.1.2 or newer and have initialized Commerce Scale Unit (CSU), you will also need to update channel components. This topic shows how to apply updates and extensions to CSU.

Updates to CSU are cumulative. This means that any update that you apply will include all previously released changes. Applying a Dynamics 365 Commerce deployable package for extensions is also a cumulative process and will replace the previously deployed version of the extension.


Before you proceed, you must first apply updates and extensions (if applicable) to the environment. For more information, see Apply updates to cloud environments.

To update CSU, complete the following steps for each:

  1. On the Environment details page, go to Environment features > Retail and Commerce.
  2. On the Commerce deployment setup page, select Update.
  3. In the selection panel, select the version to update to.
  4. You can choose to update to the newest service update to access the latest features, or you can update to the latest quality update to apply quality improvements for the currently deployed service update. For more information, see Download updates from Lifecycle Services (LCS).
  5. You can choose to apply an extension at the same time.

To apply an extension to a CSU, complete the following steps:

  1. On the Commerce deployment setup page, select Apply Extension.
  2. In the selection panel, select the extension to apply.


You must first upload the Commerce deployable package to the project asset library in Microsoft Dynamics Lifecycle Services (LCS) before you can select to deploy it on the Commerce deployment setup page in LCS.

Both Apply updates and Apply extension operations will involve a period of downtime that may last up to 1 hour, or in some cases up to 2 hours or more. For example, when updating non-US locations of CSU, large data volumes, or complex schema updates. For a realistic estimate of the downtime duration, note the downtime duration in Sandbox UAT for an equivalent update and dataset that you plan to use in your production environment. During this time, the following will occur:

  • Cloud-hosted Commerce channels will not function (unless POS offline capability is enabled).
  • POS devices that have the offline capability feature enabled will have reduced functionality.
  • Any e-commerce clients that are dependent on CCSU will be disrupted.
  • Channels hosted on CSUs will remain unaffected.
  • Head office functionality will remain unaffected.


Applying an extension and an update at the same time requires a single downtime, and can be an effective way of averting multiple downtimes.

View history

To view the history of recent operations on a Scale Unit, select History on the Action tab to open the Scale Unit History page. On this page, you can view recent operations such as initialize, service update, quality update, version, extension details, and other relevant information.

CSU auto-update sequence


Auto-update for CSU is being gradually rolled out to all Commerce customers. If you are a LCS project owner or environment administrator, you'll recieve an email notification when CSU auto-update is rolled out to your LCS project.

When CSU is auto-updated by Microsoft, it takes place in the following sequence.

CSU auto-update sequence


Can you tell us about your documentation language preferences? Take a short survey.

The survey will take about seven minutes. No personal data is collected (privacy statement).