Business Central upgrade compatibility matrix
You can upgrade from one major version of Business Central to the next. However, minor updates are regularly made available for each major release, like 23.11 or 24.5. Whether you're upgrading from one on-premises version to another, or you're migrating to Business Central online, it's important to target an update versions that are compatible with your current version.
Learn more about the supported paths in Supported Upgrade Paths. For an overview of compatibility across minor versions, refer to the relevant sections in this article.
Tip
Some versions are marked with 1, which means that the compatible upgrade versions for that version aren't available yet. If you are currently operating on this version, you'll have to wait until the next round of updates before you upgrade.
Before choosing the target version
Before you choose the target version for your upgrade, read the Some Known Issues article. This article describes issues in Business Central versions that affect upgrade.
Version 24 compatibility
The following table lists the Business Central 23 versions and the minimum version of later releases that are compatible for upgrade.
| V24 update | V25 update |
|---|---|
| 24.0 to 24.5 | 25.0 |
| 24.6 | 25.1 |
| 24.7[1] | 25.2 |
Version 23 compatibility
The following table lists the Business Central 23 update versions and the minimum update versions of later releases that are compatible for upgrade.
| V23 update | V24 update | V25 update |
|---|---|---|
| 23.0 to 23.5 | 24.0 | 25.0 |
| 23.6 | 24.1 | 25.0 |
| 23.7 | 24.2 | 25.0 |
| 23.8 | 24.3 | 25.0 |
| 23.9 | 24.4 | 25.0 |
| 23.10 | 24.5 | 25.0 |
| 23.11 | 24.6 | 25.0 |
| 23.12 | 24.7 | 25.1 |
| 23.13[1] | 24.8 | 25.2 |
Get a list of all available updates for Business Central 2023 Release Wave 2 at Released Updates for Microsoft Dynamics 365 Business Central 2023 Release Wave 2 on-premises.
Version 22 compatibility
The following table lists the Business Central 22 update versions and the minimum update versions of later releases that are compatible for upgrade.
| V22 update | V23 update | V24 update | V25 update |
|---|---|---|---|
| 22.0 to 22.5 | 23.0 | 24.0 | 25.0 |
| 22.6 | 23.1 | 24.0 | 25.0 |
| 22.7 | 23.2 | 24.0 | 25.0 |
| 22.8 | 23.3 | 24.0 | 25.0 |
| 22.9 | 23.4 | 24.0 | 25.0 |
| 22.10 | 23.5 | 24.0 | 25.0 |
| 22.11 | 23.6 | 24.0 | 25.0 |
| 22.12 | 23.7 | 24.1 | 25.0 |
| 22.13 | 23.8 | 24.2 | 25.0 |
| 22.14 | 23.9 | 24.3 | 25.0 |
| 22.15 | 23.10 | 24.4 | 25.0 |
| 22.16 | 23.11 | 24.5 | 25.0 |
| 22.17 | 23.12 | 24.6 | 25.0 |
| 22.18[1] | 23.13 | 24.7 | 25.1 |
Get a list of all available updates for Business Central 2023 Release Wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2023 Release Wave 1 on-premises.
Note
If a link to an update isn't working, it may be due to a delay in the release. However, the update will be available soon. Please check back in a couple days or follow our release announcements on https://twitter.com/MSDYN365BC or https://aka.ms/BCYammer. We apologize for the inconvenience.
Version 21 compatibility
The following table lists the Business Central 21 update versions and the minimum update versions of later releases that are compatible for upgrade.
Note
Although the table lists the minimum compatible update versions, we recommend upgrading to the latest update version for the release you are upgrading to.
| V21 update | V22 update | V23 update | V24 update |
|---|---|---|---|
| 21.0 to 21.5 | 22.0 | 23.0 | 24.0 |
| 21.6 | 22.1 | 23.0 | 24.0 |
| 21.7 | 22.2 | 23.0 | 24.0 |
| 21.8 | 22.3 | 23.0 | 24.0 |
| 21.9 | 22.4 | 23.0 | 24.0 |
| 21.10 | 22.5 | 23.0 | 24.0 |
| 21.11 | 22.6 | 23.0 | 24.0 |
| 21.12 | 22.7 | 23.1 | 24.0 |
| 21.13 | 22.8 | 23.2 | 24.0 |
| 21.14 | 22.9 | 23.3 | 24.0 |
| 21.15 | 22.10 | 23.4 | 24.0 |
| 21.16 | 22.11 | 23.5 | 24.0 |
| 21.17 | 22.12 | 23.6 | 24.0 |
| 21.18 | 22.13 | 23.7 | 24.1 |
Get a list of all available updates for Business Central 2022 Release Wave 2 at Released Updates for Microsoft Dynamics 365 Business Central 2022 Release Wave 2 on-premises.
Note
Version 21.18 is the last update for Business Central 2022 Release Wave 2.
Version 20 compatibility
The following table lists the Business Central 20 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 20.18 (published in October 2023) is the last update for Business Central 2022 release wave 1.
All version 20 updates are compatible for upgrade with Business Central 2024 release wave 1 (version 24) and later release waves.
| Version 20 | Version 21 | Version 22 | Version 23 |
|---|---|---|---|
| 20.0 to 20.5 | 21.0 | 22.0 | 23.0 |
| 20.6 | 21.1 | 22.0 | 23.0 |
| 20.7 | 21.2 | 22.0 | 23.0 |
| 20.8 | 21.3 | 22.0 | 23.0 |
| 20.9 | 21.4 | 22.0 | 23.0 |
| 20.10 | 21.5 | 22.0 | 23.0 |
| 20.11 | 21.6 | 22.0 | 23.0 |
| 20.12 | 21.7 | 22.1 | 23.0 |
| 20.13 | 21.8 | 22.2 | 23.0 |
| 20.14 | 21.9 | 22.3 | 23.0 |
| 20.15 | 21.10 | 22.4 | 23.0 |
| 20.16 | 21.11 | 22.5 | 23.0 |
| 20.17 | 21.12 | 22.6 | 23.0 |
| 20.18 | 21.13 | 22.7 | 23.1 |
Get a list of all available updates for Business Central 2022 Release Wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2022 Release Wave 1 on-premises.
Version 19 compatibility
The following table lists the Business Central 19 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 19.18 (published in April 2022) is the last update for Business Central 2021 release wave 2.
All version 19 updates are compatible for upgrade with Business Central 2023 release wave 2 (version 23) and later release waves.
| Version 19 | Version 20 | Version 21 | Version 22 |
|---|---|---|---|
| 19.0 to 19.5 | 20.0 | 21.0 | 22.0 |
| 19.6 | 20.1 | 21.0 | 22.0 |
| 19.7 | 20.2 | 21.0 | 22.0 |
| 19.8 | 20.3 | 21.0 | 22.0 |
| 19.9 | 20.4 | 21.0 | 22.0 |
| 19.10 | 20.5 | 21.0 | 22.0 |
| 19.11 | 20.6 | 21.0 | 22.0 |
| 19.12 | 20.7 | 21.1 | 22.0 |
| 19.13 | 20.8 | 21.2 | 22.0 |
| 19.14 | 20.9 | 21.3 | 22.0 |
| 19.15 | 20.10 | 21.4 | 22.0 |
| 19.16 | 20.11 | 21.5 | 22.0 |
| 19.17 | 20.12 | 21.6 | 22.0 |
| 19.18[1] | 20.13 | 21.7 | 22.1 |
Get a list of all available updates for Business Central 2021 Release Wave 2 at Released Updates for Microsoft Dynamics 365 Business Central 2021 Release Wave 2 on-premises.
Version 18 compatibility
The following table lists the Business Central 18 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 18.8 (published in October 2022) is the last update for Business Central 2021 release wave 1.
All version 18 updates are compatible for upgrade with Business Central 2023 release wave 1 (version 22) and later release waves.
| Version 18 | Version 19 | Version 20 | Version 21 |
|---|---|---|---|
| 18.0 to 18.5 | 19.0 | 20.0 | 21.0 |
| 18.6 | 19.1 | 20.0 | 21.0 |
| 18.7 | 19.2 | 20.0 | 21.0 |
| 18.8 | 19.3 | 20.0 | 21.0 |
| 18.9 | 19.4 | 20.0 | 21.0 |
| 18.10 | 19.5 | 20.0 | 21.0 |
| 18.11 | 19.6 | 20.0 | 21.0 |
| 18.12 | 19.7 | 20.1 | 21.0 |
| 18.13 | 19.8 | 20.2 | 21.0 |
| 18.14 | 19.9 | 20.3 | 21.0 |
| 18.15 | 19.10 | 20.4 | 21.0 |
| 18.16 | 19.11 | 20.5 | 21.0 |
| 18.17 | 19.12 | 20.6 | 21.0 |
| 18.18 | 19.13 | 20.7 | 21.1 |
Get a list of the available updates for Business Central 2021 Release Wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2021 Release Wave 1 on-premises.
Version 17 compatibility
The following table lists the Business Central 17 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 17.17 (published in April 2022) is the last update for Business Central 2020 release Wave 2.
All version 17 updates are compatible for upgrade with Business Central 2022 release wave 2 (version 21) and later release waves.
| Version 17 | Version 18 | Version 19 | Version 20 |
|---|---|---|---|
| 17.0 to 17.5 | 18.0 | 19.0 | 20.0 |
| 17.6 | 18.1 | 19.0 | 20.0 |
| 17.7 | 18.3 | 19.0 | 20.0 |
| 17.8 | 18.4 | 19.0 | 20.0 |
| 17.9 | 18.5 | 19.0 | 20.0 |
| 17.10 | 18.6 | 19.0 | 20.0 |
| 17.11 | 18.7 | 19.1 | 20.0 |
| 17.12 | 18.8 | 19.2 | 20.0 |
| 17.13 | 18.9 | 19.3 | 20.0 |
| 17.14 | 18.10 | 19.4 | 20.0 |
| 17.15 | 18.11 | 19.5 | 20.0 |
| 17.16 | 18.12 | 19.6 | 20.0 |
| 17.17 | 18.13 | 19.7 | 20.1 |
Get a list of the available updates for Business Central 2020 Release Wave 2 at Released updates for Microsoft Dynamics 365 Business Central 2020 Release Wave 2.
Version 16 compatibility
The following table lists the Business Central 16 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 16.17 (published October 2021) is the last update for Business Central 2020 release wave 1.
All version 16 updates are compatible for upgrade with Business Central 2022 release wave 1 (version 20) and later release waves.
| Version 16 | Version 17 | Version 18 | Version 19 |
|---|---|---|---|
| 16.0 to 16.5 | 17.0 | 18.0 | 19.0 |
| 16.6 | 17.1 | 18.0 | 19.0 |
| 16.7 | 17.2 | 18.0 | 19.0 |
| 16.8 | 17.3 | 18.0 | 19.0 |
| 16.9 | 17.4 | 18.0 | 19.0 |
| 16.10 | 17.5 | 18.0 | 19.0 |
| 16.11 | 17.6 | 18.0 | 19.0 |
| 16.12 | 17.7 | 18.1 | 19.0 |
| 16.13 | 17.8 | 18.3 | 19.0 |
| 16.14 | 17.9 | 18.4 | 19.0 |
| 16.15 | 17.10 | 18.5 | 19.0 |
| 16.16 | 17.11 | 18.6 | 19.0 |
| 16.17 | 17.12 | 18.7 | 19.1 |
Get a list of the available updates for Business Central 2020 Release Wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2020 Release Wave 1 on-premises.
Version 15 compatibility
The following table lists the Business Central 15 versions and the minimum version of later releases that are compatible for upgrade.
Note
Version 15.18 (published in April 2021) is the last update for Business Central 2019 release wave 2.
All version 15 updates are compatible for upgrade with Business Central 2021 release wave 2 (version 19) and later release waves.
| Version 15 | Version 16 | Version 17 | Version 18 |
|---|---|---|---|
| 15.0 to 15.4 | 16.0 | 17.0 | 18.0 |
| 15.5 | 16.1 | 17.0 | 18.0 |
| 15.6 | 16.2 | 17.0 | 18.0 |
| 15.7 | 16.3 | 17.0 | 18.0 |
| 15.8 | 16.4 | 17.0 | 18.0 |
| 15.9 | 16.5 | 17.0 | 18.0 |
| 15.10 | 16.6 | 17.0 | 18.0 |
| 15.11 | 16.7 | 17.1 | 18.0 |
| 15.12 | 16.8 | 17.2 | 18.0 |
| 15.13 | 16.9 | 17.3 | 18.0 |
| 15.14 | 16.10 | 17.4 | 18.0 |
| 15.15 | 16.11 | 17.5 | 18.0 |
| 15.16 | 16.12 | 17.6 | 18.0 |
| 15.17 | 16.13 | 17.7 | 18.1 |
Get a list of the available updates for Business Central 2019 Release Wave 2 at Released Updates for Microsoft Dynamics 365 Business Central 2019 Release Wave 2 on-premises.
Version 14 compatibility
Note
If you're coming from version 13 or earlier, Business Central Spring 2019 (v14) is a required step to upgrade to the latest version of Business Central. However, mainstream support for version 14 ends in October 2023, and minor updates to the version are no longer available. New customers can't use version 14 in production, but only as a path for upgrading to latest version. Existing customers on version 14 remain supported by Microsoft as defined in the Fixed Lifecycle Policy.
All version 14 updates are compatible with any update version of Business Central 2024 release wave 1 and later release waves.
The following table lists the Business Central 14 versions and the minimum version of later releases that are compatible for upgrade. For example, you can upgrade version 14.0 to any 15 or 16 version. You can only upgrade version 14.11 to version 15.5 (or later). Learn more about the available updates for Business Central 2019 Release Wave 1 at Released cumulative updates for Microsoft Dynamics 365 Business Central Spring 2019 Update on-premises.
Note
If a link to an update isn't working, it may be due to a delay in the release. However, the update will be available soon. Please check back in a couple days or follow our release announcements on https://twitter.com/MSDYN365BC or https://aka.ms/BCYammer. We apologize for the inconvenience.