Update cycles

This article provides an overview of what you need to know about how a major or minor update for Business Central rolls out. It includes key dates, actions you need to take, and answers some common questions.

Business Central online is a service that consists of a Microsoft-maintained platform and business functionality. Many Microsoft partners provide extra business functionality, such as to address specific industry or localization needs. Both business functionality and service components are monitored continuously and updated as appropriate.

New capabilities roll out in release waves that consist of a major update and monthly minor updates. Most capabilities are made available in major updates, but some become available in minor updates. Critical fixes roll out as soon as possible after they pass tests and are verified in Microsoft's protected staging environment. You can always refer to the release plan for an overview of new and upcoming functionality. Learn about new functionality, bug fixes, and improvements shipped in recent versions in What's new or changed.

Tip

All updates that Microsoft applies to Business Central online are also shipped with the subsequent cumulative update for Business Central on-premises. For example, see Update 24.5 for Microsoft Dynamics 365 Business Central online 2024 release wave 1 and Dynamics 365 Business Central on-premises 2024 release wave 1 updates, respectively.

Microsoft is committed to delivering predictable updates to the service. Updates are continuous, touchless updates that provide new features and functionality. They eliminate the need to do expensive upgrades every few years. Administrators can set a maintenance window for each environment that determines when Microsoft is allowed to update that environment. For more information, see Managing Updates in the Business Central Admin Center. Scheduled minor and major updates, and unscheduled critical fixes, respect the maintenance window set on each environment.

You are in control and manage how your organization receives these updates. Microsoft applies updates to each environment based on your configuration. The only exception is how Microsoft maintains the underlying platform with invisible updates during low traffic hours, for example. For more information, see the service updates section.

The Dynamics 365 team designs and develops each new update. Any new update is first validated by the feature team, then validated in combination with the full product. During this time, extensive testing is done on various test topologies. A compatibility checker also runs tests to ensure backward compatibility.

Major updates

There are two major update cycles per year, with major releases every April and October. Major updates introduce new features, enhancements, and platform improvements. For each major update cycle, the following periods apply.

Preview period

The preview period allows for testing of the new functionality before the version is made available as update to your environment. Administrators can create a Sandbox environment from the Business Central administration center on the new version, for example to try out new functionality or test compatibility of extensions in a cloud environment. This period typically starts a month before the release of the new major version, that is, every March and September. Learn more in Preparing for major updates with preview environments.

Update period

The update period starts when a new major version is generally available (GA), typically the first workday of April and October. After general availability, new environments are created on the new major version. The new major version is available as an update to existing environments about a week after general availability, though the exact timing might differ by environment.

The update period lasts for five calendar months, ending in early September for update periods that start in April, and in early March for update periods that start in October. Administrators can reschedule the update to any date within the update period from the Business Central administration center. Learn more in Rescheduling updates.

Scheduled update attempts that don't succeed are automatically rescheduled for seven days later, and administrators can reschedule them to any other date within the update period. Learn more in the Completed updates section.

When a new version is available as update on the environment, Notification recipients receive an email notification and environments enabled with telemetry receive a signal with the LC0100 tag.

Grace period

The grace period starts when the update period ends and lasts one month. It occurs every September for the update period starting in April and every March for the update period starting in October. During the grace period, you can't reschedule an update to a later date or to a target version within the environment's current major version. Microsoft automatically reschedules unsuccessful environment updates to be reattempted seven days later. Administrators can only reschedule this attempt to an earlier date or to a different target version within the next major version. To ensure the environment update succeeds during the grace period, Microsoft alerts administrators in the Business Central administration center and might send in-product notifications to end users about the upcoming enforced update period. Learn more in When Microsoft can't update apps or per-tenant extensions (PTEs).

Tip

We recommend that you keep any apps and per-tenant extensions ready to update at any given time, and that you actively test compatibility. Developers can get tips and guidance in the developer docs here: Maintain AppSource Apps and Per-Tenant Extensions. Admins can install, update, and uninstall apps in the Business Central administration center as described here: Managing Apps.

Enforced update period

The enforced period starts when the grace period ends. During this period, any extensions causing the update to the next major version to fail, for example, because of compatibility issues, might be automatically uninstalled from the environment so that the update succeeds. Data belonging to these uninstalled extensions isn't deleted from the environment and can be recovered by installing a compatible extension version after the update succeeds. Learn more in When Microsoft can't update apps or PTEs.

Minor updates

Minor updates are released every month in which there's no major update release, that is, every month except April and October. These updates contain application changes that are critical improvements to the service, including regulatory updates. Like major updates, minor updates are generally available at the start of each calendar month. After a minor update is general available, new environments use the new minor version by default. The new minor version becomes available as an update to environments on the previous version about a week after general availability. The exact timing can vary by environment.

Release plans

Get an overview of the release plans at Dynamics 365 and Microsoft Power Platform release plans. For Business Central release plans, select a release wave under Dynamics 365, then look under SMB in the table of contents. Learn about new functionality, bug fixes, and improvements shipped in recent versions in What's new or changed.

Completed updates

An environment update completes when it succeeds, fails, or is canceled because the update window ends.

An environment might fail to update for various reasons, such as:

  • Per-tenant extension compatibility issues
  • AppSource app compatibility issues
  • Internal update issues

When an update fails or is canceled, the environment restores to the original application version so users can connect to it again. The environment is rescheduled for a new update attempt in seven days. To resolve the issue and retry the update, change the update date to an earlier or current date.

Important

If a failed update was scheduled by Microsoft services, not an admin, and the target version isn't the latest available, the next update might be rescheduled to use the latest available version. Updates scheduled by administrators aren't rescheduled unless the update period ends for the selected target version.

If Microsoft can't do the update on the selected date, notification recipients get an email that the environment update is rescheduled for seven days later. Administrators can change the date in the Business Central administration center to any other allowed date, including the current date.

When an update succeeds, the system schedules the next update to target the latest available version and occur at least seven days later. If the successful update targeted the latest available version, the system schedules the next update to target the version planned to become available next and occur automatically on a date when it becomes available.

Note

The chosen date for a target version remains the same even if the target version and date for an environment's next update change later. If an update succeeds, and the next update scheduled by Microsoft is for a target version with a date in the future, the future date is used for the next update instead of the default seven days after the previous update finishes.

The target version and date for an environment's next update can be changed in the Business Central administration center. Learn more in Managing updates in the admin center.

Postponed updates

In critical circumstances, Microsoft might postpone the rollout of updates, for example, if a critical issue is discovered in an upcoming major version. While Microsoft addresses the issue, the updates are postponed. For environments scheduled for postponed update, notification recipients receive an email notification, and the notification is displayed in the Business Central administration center.

If the nature of the issue and the solution aren't known in advance, it's impossible to predict when updates resume. As a result, the email and the notification in Business Central administration center don't include information about the expected resume date. In these cases, Microsoft prioritizes resuming updates as soon as the issue is resolved. For environments that have an update scheduled to the version for which updates are postponed, notification recipients receive another email notification when updates resume. For environments scheduled for postponed update, notification recipients get another email when updates resume.

If you schedule an environment update for a date when updates to the selected target version are postponed, the environment isn't updated. Notification recipients get an email notification that the scheduled update didn't run. The update is automatically rescheduled for another attempt seven days later. You can reschedule the update to a different date or target version, or wait until you get an email notification that the updates resume.

Prepare, test, and learn before a major update

You can prepare yourself, users, and any customizations by trying out the new major version before your production environment is updated. The following sections provide recommendations for how to prepare for an update.

Important

We strongly recommend that you test any critical business scenarios before your production environments are updated to the new major or minor version.

Prepare for major updates by enabling select features earlier

Some new features can be switched on ahead of time on sandbox and production environments, giving you time to test and prepare for change. Most times, you can switch on features several weeks before preview environments for the major update are available.

When Microsoft releases features or feature design improvements as part of minor updates, some of these features are optional until the following major update. Administrators can turn these optional features on or off from the Feature Management page.

Learn more in Feature Management.

Prepare for major updates with preview environments

About one month before a major update, you can try out new functionality in preview environments. Preview environments are Business Central online sandbox environments that you create on a preview version of the application. When you create the new sandbox environment, choose the preview version marked as (Preview) from the version list. This way, you get a new sandbox environment with a preview version of the application.

For more information access to preview environments, see Prepare for major updates with preview environments.

Note

Previews roll out gradually across the world, so if the option is not showing up for you today, please try again tomorrow.

The newly created preview sandbox environment contains demonstration company data. Trying the preview on a copy of your current production data is not yet supported; nor is testing the upgrade from your current version to the preview. However, you can use the newly created sandbox environment for exploring and learning the new product capabilities. You can also use the preview environment to validate that any per-tenant extensions are still working as expected.

If you run your tests on a preview environment one month before the announced major release of Business Central, it is more likely that the coming updates of your production environments will go smoother. This way, you, your customers, and your code are better prepared for the official release.

We expect to update the preview version only if we discover critical issues before the major update is generally available for production environments. Apart from these potential fixes, we do not expect any further changes to the product between the preview and the official release. You can start your testing and learning activities immediately, without waiting for the official release.

Note

You will be able to test the update on a copy of your production data in a sandbox environment when we release the new update in production in April or October, respectively. When the official release becomes available, you can continue your tests on that version. You will no longer be able to create new preview sandboxes.

Important

The preview version as well as all sandbox environments that are based on it will be removed 30 days after the official release becomes available.

Learn more in Prepare for major updates with preview environments.

Prepare for major updates just before the production environment is updated

When you're notified that a new major update is available, test the new version using a copy of your current production data. Copy the production environment to a sandbox environment, and schedule the update for the sandbox environment. To start the update immediately, schedule it for the current date and set Allow the update to run outside the update window to Yes.

Microsoft monitors each update of an environment. If we detect any errors during the update, notification recipients get an email that describes the detected issues.

Service updates

The service components apply to multiple environments, such as all tenants in a region. So Microsoft schedules those updates to a time when traffic is lower in each region, typically during the evening or night. Typically, these service updates are transparent to any users, as the service is designed to manage traffic in a way that any users still working in Business Central aren't affected by these service updates.

These updates don't add or remove functionality, and they're transparent to business users.

Managing Major and Minor Updates of Business Central Online
Working with Administration Tools
The Business Central Administration Center
Managing Environments
Managing Tenant Notifications
Introduction to automation APIs
What's new or changed in Business Central