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 25.2
24.8[1] 25.3

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 24.8 25.2
23.14[1] 24.9 25.3

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.

Version 14 Version 15 Version 16 Version 17 Version 18 Version 19 Version 20 Version 21 Version 22 Version 23
14.0 (GA and cumulative update 01) 15.0 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.3 (cumulative update 02) 15.0 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.4 (cumulative update 03) 15.0 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.5 (cumulative update 04) 15.0 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.6 (cumulative update 05) 15.1 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.7 (cumulative update 06) 15.2 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.8 (cumulative update 07) 15.3 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.9 (cumulative update 08) 15.3 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.10 (cumulative update 09) 15.4 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.11 (cumulative update 10) 15.5 16.0 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.12 (cumulative update 11) 15.6 16.1 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.13 (cumulative update 12) 15.7 16.2 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.14 (cumulative update 13) 15.8 16.3 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.15 (cumulative update 14) 15.9 16.4 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.16 (cumulative update 15) 15.10 16.5 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.17 (cumulative update 16) 15.11 16.6 17.0 18.0 19.0 20.0 21.0 22.0 23.0
14.18 (cumulative update 17) 15.12 16.7 17.1 18.0 19.0 20.0 21.0 22.0 23.0
14.19 (cumulative update 18) 15.13 16.8 17.2 18.0 19.0 20.0 21.0 22.0 23.0
14.20 (cumulative update 19) 15.14 16.9 17.3 18.0 19.0 20.0 21.0 22.0 23.0
14.21 (cumulative update 20) 15.15 16.10 17.4 18.0 19.0 20.0 21.0 22.0 23.0
14.22 (cumulative update 21) 15.16 16.11 17.5 18.0 19.0 20.0 21.0 22.0 23.0
14.23 (cumulative update 22) 15.17 16.12 17.6 18.0 19.0 20.0 21.0 22.0 23.0
14.24 (cumulative update 23) None 16.13 17.7 18.1 19.0 20.0 21.0 22.0 23.0
14.25 (cumulative update 24) None 16.14 17.8 18.3 19.0 20.0 21.0 22.0 23.0
14.26 (cumulative update 25) None 16.15 17.9 18.4 19.0 20.0 21.0 22.0 23.0
14.27 (cumulative update 26) None 16.16 17.10 18.5 19.0 20.0 21.0 22.0 23.0
14.28 (cumulative update 27) None 16.17 17.11 18.6 19.0 20.0 21.0 22.0 23.0
14.29 (cumulative update 28) None 16.18 17.12 18.7 19.1 20.0 21.0 22.0 23.0
14.30 (cumulative update 29) None None 17.13 18.8 19.2 20.0 21.0 22.0 23.0
14.31 (cumulative update 30) None None 17.14 18.9 19.3 20.0 21.0 22.0 23.0
14.32 (cumulative update 31) None None 17.15 18.10 19.4 20.0 21.0 22.0 23.0
14.33 (cumulative update 32) None None 17.16 18.11 19.5 20.0 21.0 22.0 23.0
14.34 (cumulative update 33) None None 17.7 18.12 19.6 20.0 21.0 22.0 23.0
14.35 (cumulative update 34) None None 17.18 18.13 19.7 20.1 21.0 22.0 23.0
14.36 (cumulative update 35) None None None 18.14 19.8 20.2 21.0 22.0 23.0
14.37 (cumulative update 36) None None None 18.15 19.9 20.3 21.0 22.0 23.0
14.38 (cumulative update 37) None None None 18.16 19.10 20.4 21.0 22.0 23.0
14.39 (cumulative update 38) None None None 18.17 19.11 20.5 21.0 22.0 23.0
14.40 (cumulative update 39) None None None 18.18 19.12 20.6 21.0 22.0 23.0
14.41 (cumulative update 40) None None None None 19.13 20.7 21.1 22.0 23.0
14.42 (cumulative update 41) None None None None 19.14 20.8 21.2 22.0 23.0
14.43 (cumulative update 42) None None None None 19.5 20.9 21.3 22.0 23.0
14.44 (cumulative update 43) None None None None 19.16 20.10 21.4 22.0 23.0
14.45 (cumulative update 44) None None None None 19.17 20.11 21.5 22.0 23.0
14.46 (cumulative update 45) None None None None 19.18 20.12 21.6 22.0 23.0
14.47 (cumulative update 46) None None None None None 20.13 21.7 22.1 23.0
14.48 (cumulative update 47) None None None None None 20.14 21.8 22.2 23.0
14.49 (cumulative update 48) None None None None None 20.15 21.9 22.3 23.0
14.50 (cumulative update 49) None None None None None 20.16 21.10 22.4 23.0
14.51 (cumulative update 50) None None None None None 20.17 21.11 22.5 23.0
14.52 (cumulative update 51) None None None None None 20.18 21.12 22.6 23.0
14.53 (cumulative update 52) None None None None None None 21.13 22.7 23.1

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.

Relevant information

Upgrading to Business Central