One Version service updates FAQ

In July 2018 we announced a change to the way we deliver Dynamics 365 updates that will help you stay current in a consistent, predictable, and seamless manner. This FAQ is intended to provide clarity on the Finance and Operations service updates, processes, and tools you can use to prepare for it. We will continue to add additional information to this topic as needed.

Service updates

What product versions are impacted by service updates?

Version Description
8.1 and later All customers on 8.1 and later will be scheduled for updates monthly with a combined application and platform update starting November 2018. You will be required to have an update that's no older than 3 months.
8.0 Customers on 8.0 will receive a monthly platform and financial reporting update. You will be required to have an update that's no older than 3 months. The 8.0 lifecycle ends in April 2019. We encourage customers on 8.0 to update to 8.1 by December 1, 2018. This process is like a regular package update. For detailed documentation, see the Update environments from version 8.0 to 8.1 topic.
7.x Customers on 7.x will receive a monthly platform and financial reporting update. You will be required to have an update that's no older than 3 months. You are required to upgrade to 8.1 before April 2019 (unless extensions are not available, the only overlayered version in market will be version 7.3). Starting April 2019, the service will be updated to version 10.0.

What does the update contain?

For 8.1 and later, service updates will contain application (including financial, reporting, and Retail) and platform changes that are critical improvements to the service including regulatory updates. New experiences will be opt-in. The service updates are backward compatible. There will be a single version representing this update.

What is a regulatory update?

A regulatory update is a new feature or an existing feature change required by law (usually for a specific country/region). The regulatory update is always required by a specific law enforcement date (LED) and should be enabled by this date or earlier.

What's the upcoming schedule of updates?

Service updates will be available each month starting in November 2018. Microsoft will apply the updates monthly, based on the selected maintenance window. You are required to have an update no older than 3 months.

Are there any major updates post 8.1?

There will be 2 major updates in April and October where new experiences will be enabled. Major updates will not require code or data upgrade. Breaking changes will be communicated 12 months in advance such that customers can plan accordingly. Such a change will only be introduced during a major update. The 10.0 release, which will be available in April 2019, will also be an update and not an upgrade.

What does it mean when an update is backward compatible?

Backward compatibility covers binary and functional compatibility. Binary compatibility means that you can apply an update on any runtime environment without needing to recompile, reconfigure, or redeploy customizations. This also means that on a development environment at design time, X++ public and protected APIs and metadata are not modified or deleted. If Microsoft needs to break compatibility by removing obsolete APIs, it will be communicated 12 months in advance and follow a deprecation schedule. Functional compatibility is about user experience, all new experiences will be opt-in.

Backward compatibility does not include non-X++/metadata APIs. Microsoft reserves the right to update versions of any dependencies the product uses, as well as remove dependencies without early warning. Microsoft does not commit to maintain backwards compatibility of dependent software libraries unless expressly stated.

Do these updates apply to on-premises?

Refer to the Software lifecycle policy and on-premises releases topic for the specific expiration dates of the version that you are on. The process of the updates outlined in this topic only apply to the cloud service.


How will Microsoft ensure quality of releases?

Ensuring quality of the release is a fundamental principle that's enabled through a series of progressive, rigorous, automated validations as described in Standard and First release service updates.

Can I select the day and time to update?

Customers can configure the day and maintenance time windows in Lifecycle Services (LCS). Email will be sent to those individuals who opt in to receive LCS notifications with instructions included on how to update. Customers will be able to select the designated tier 2/UAT sandbox for the update. Customers will have 5 business days for testing and validation. Customers can optionally choose to apply the update earlier to all environments through Lifecycle Services and even earlier through early access programs. Customers are responsible for deploying the update to any additional sandbox or developer/build (tier 1) environments.

How do I update to the latest version?

Users can update to the latest version using the tiles on the Environment details page in LCS. After the update is released by Microsoft, the tile will show the latest update. Customers can choose to apply the update on their own by going through the update experience on their sandbox and production environments. Documentation will also be made available on

What is the expected downtime?

The expected downtime for a successful update is 30 minutes to 1 hour. However, we ask for three hours of downtime in case issues occur while the update is applied. We are actively working to reduce the downtime that is required, and you should expect improvements in the next few months.

What's the process for deprecation?

Deprecation will be announced by a notice 12 months prior to the deprecation. The functionality will only be deprecated during a major update.

Can I delay an update?

You can pause an update up to 3 months by way of LCS configuration. After this period, an update will be scheduled and monthly updates resumed. The update experience for a delayed update will incur additional downtime.

What if I find an issue during the sandbox update?

If you find an issue when doing validations in a sandbox environment, you can request to skip the update through LCS directly by providing a valid support ticket number and a business justification. The request will be reviewed by Microsoft and if approved you will be left out of that month's update.

How much time do I get for validation?

You will get five (5) days for validation once the update is applied to your sandbox environment. If you need more time, you can sign up for an early access automatic update to one of your sandbox environments. This will provide you with additional time to test the update prior to a production roll out. More information about this program will be available shortly.

Will rollback be supported after an update is applied?

Rollback will be supported in the coming months.

How will my ISVs stay current?

Service updates to customer environments will be backward compatible and no action is required by the Independent software vendors (ISVs). ISVs develop on the minimum required platform release that their code depends on. Breaking changes will have a 12-month lead time to enable ISVs to include and validate. We recommend that the ISVs be part of our Partner early access program, so that they can get early access to the platform bits and validate their solutions against the update before it's made generally available.

What about new features?

All new features will be opt-in for a 12-month period and will not require any change management until you choose to enable the feature.

Are batch jobs suspended during a service update?

Batch jobs are suspended during the maintenance windows and resume when the maintenance is completed.


How can I get early access to non-released platform updates?

You can join the First release program, where Microsoft will keep your system always current with the latest updates.

Is there tooling available to support testing the latest release?

The Regression Suite Automation Tool for Finance and Operations is available now. This tool significantly reduces the time and cost of user acceptance testing. User acceptance testing is typically required before taking a Microsoft application update or applying custom code and configurations to your Dynamics 365 for Finance and Operations production environment. It enables functional power users to record business tasks using the Finance and Operations Task recorder and convert them into a suite of automated tests without the need to write source code. Test libraries are stored and distributed in Lifecycle Services using the Business Process Modeler (BPM) libraries and fully integrated with Azure DevOps for test execution, reporting, and investigation. Test data parameters are decoupled from test steps and stored in Excel data files.

How can I test and validate that the integrations continue to work?

Data task automation lets you easily repeat many types of data tasks and validate the outcome of each task. You can also use automated testing of data entities by using task outcome validation. For more information, see the Data task automation topic.

How can I determine what's changed in a service update?

The Release notes are the primary source of information for all new features and changes for a release. Features will also include help topics in as needed. An impact analysis tool will be available in LCS to help you better understand the impact to the features that you use.

Preparing for One Version

How can I log an extensibility request?

Extensibility requests can be logged in LCS. Details are available in the Extensibility requests topic. Please note the following timelines to log and use the available extensions.

Date Extensibility requests
January 2019 All extensibility requests must be logged by January 1, 2019. ISVs and customers are requested to analyze the code and make these requests by this time. We will not provide exceptions to stay on 7.3 after April 2019, if the request has not been filed by January 1, 2019.
December 2019 Extensions will be available on/ before December 31, 2019 for the requests logged by January 1, 2019. Customers using these extensions are required to move to current version by April 2020.

What does end of service mean?

Microsoft will not provide any fixes to issues on versions that have reached end of service. Microsoft will also not investigate or troubleshoot any issue that you may encounter on an older version. If you encounter an issue on a version that has reached end of service, you will be required to update to the latest update and report the issue if it persists.

All environments will continue to be operated by Microsoft. All automatic processes around your environments, such as monitoring or self-healing, will also continue as is.

Will individual hotfixes be supported?

Individual hotfixes will not be supported after 8.1. Customers must update to the latest cumulative update available to apply the fix (such as 8.1.1). Critical fixes will also be cumulative and available through the LCS servicing experience.

How can I upgrade to 8.x?

Refer to the Process for moving to the latest update of Finance and Operations topic to learn how to upgrade to the latest application. Updating from 8.0 to 8.1 will not require any data upgrade and will be a self-serve update with much reduced downtime.

Retail service updates

What components of my solution will be impacted by One Version service updates?

All cloud components including Retail Server and Cloud POS will be updated at the same cadence as your Dynamics 365 headquarters.

What options are available to minimize impact to my Retail cloud components?

Retail cloud components will require the same down time as your Dynamics 365 headquarters. In an upcoming release, the Retail Cloud Scale Unit (RCSU) will be available to reduce and further schedule updates to your deployment. Please refer to our published release information on our documentation and release notes sites for additional details on RCSU.

Will there be options to take individual hotfixes for my retail solution components?

All fixes and updates for retail components will be cumulative.

What are the maintenance downtime requirements that may impact channel operations?

For retailers with a business need for redundancy, Modern POS offline capability allows core retail POS operations to be available for use while disconnected from the internet or while the cloud environment is being updated. Stores operating with Retail Store Scale Unit will also continue to operate with support for core POS operations during cloud maintenance windows. For more information, see Online and offline point of sale (POS) operations.

When will I need to update my in-store components?

All in-instore components must be running released software that is less than one year old in order to maintain support. Customers are responsible for updating self-hosted components (such as components installed in stores or in privately managed datacenters) and ensuring that the installed versions of these components are actively supported.

Will there continue to be backward compatibility for the in-store retail components?

Updates to components hosted in the cloud will continue to preserve backward compatibility with component versions self-hosted by the Retailer (such as components installed in stores or in privately managed datacenters - Modern Point of Sale, Retail Store Scale Unit, Hardware Station) for 12 months after the release date for that version. Self-hosted components do not need to be updated at the same time as cloud-hosted components and can be updated on a separate cadence allowing time to roll-out updates to stores.

What options are available for updating in-store components across my organization?

Customers can choose to update self-hosted components manually at each store or use mass update tools such as Microsoft System Center Configuration Manager, Microsoft Intune, etc.

What options do I have to slowly enable new functionality across my retail channels?

Microsoft provides several mechanisms to progressively roll-out and enable functional enhancements across stores, devices, and users.

  • Screen layout designer – Most visual elements in POS are configured and centrally managed by an administrative user in the customer organization. This means that new POS operations will not automatically be displayed on POS unless explicitly configured for inclusion in corresponding screen layouts. Screen layouts are configured using Screen layout designer and can be specific to a store or POS device. For more information, see Screen layouts for the point of sale (POS).
  • Functionality profiles, POS permissions, Retail parameters – Significant elements of functionality in POS are typically configurable by the user. This can be configured through functionality profiles, POS permissions, retail parameters, or other controls which allow for device, register, store, or user-level functionality control in applicable scenarios.
  • Modern Point of Sale and Retail Store Scale Unit – Because Modern Point of Sale and Retail Store Scale Unit are self-hosted by the retailer, topologies which include either of these components enable roll out of updates at a separate (and slower) cadence, and in a more granular fashion than with cloud-only topologies.