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 27.11 or 28.1. 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 <a name="1">1</a>, 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.

Important


You can't upgrade directly from version 24 or earlier to version 26 and later. Upgrade to version 25 first.

Version 28 compatibility

The following table lists the Business Central 28 update versions and the minimum version of later releases that are compatible for upgrade.

Version 28Version 29
28.0 to 28.529.0
28.629.1
28.7[1]29.2

Version 27 compatibility

The following table lists the Business Central 27 update versions and the minimum version of later releases that are compatible for upgrade.

Get a list of all available version 27 at Released Updates for Microsoft Dynamics 365 Business Central 2025 release wave 2 on-premises.

Version 26 compatibility

The following table lists the Business Central 26 update versions and the minimum version of later releases that are compatible for upgrade.

Note

This release wave isn't updated anymore.

Get a list of all available updates for Business Central 2025 release wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2025 release wave 1 on-premises.

Version 25 compatibility

The following table lists the Business Central 25 update versions and the minimum version of later releases that are compatible for upgrade.

Note

This release wave isn't updated anymore.

Get a list of all available updates for Business Central 2024 release wave 2 at Released Updates for Microsoft Dynamics 365 Business Central 2024 release wave 2 on-premises.

Version 24 compatibility

The following table lists the Business Central 24 update versions and the minimum version of later releases that are compatible for upgrade.

Note

This release wave isn't updated anymore.

Get a list of all available updates for Business Central 2024 release wave 1 at Released Updates for Microsoft Dynamics 365 Business Central 2024 release wave 1 on-premises.

Version 23 compatibility

Note

This release wave isn't updated anymore.

The following table lists the Business Central 23 update versions and the minimum update versions of later releases that are compatible for upgrade.

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

Note

This release wave isn't updated anymore.

The following table lists the Business Central 22 update versions and the minimum update versions of later releases that are compatible for upgrade.

Version 22Version 23Version 24Version 25
22.0 to 22.523.024.025.0
22.623.124.025.0
22.723.224.025.0
22.823.324.025.0
22.923.424.025.0
22.1023.524.025.0
22.1123.624.025.0
22.1223.724.125.0
22.1323.824.225.0
22.1423.924.325.0
22.1523.1024.425.0
22.1623.1124.525.0
22.1723.1224.625.0
22.18[1]23.1324.725.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.

Version 21 compatibility

Note

This release wave isn't updated anymore.

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.

Version 21Version 22Version 23Version 24Version 25
21.0 to 21.522.023.024.0Any update
21.622.123.024.0Any update
21.722.223.024.0Any update
21.822.323.024.0Any update
21.922.423.024.0Any update
21.1022.523.024.0Any update
21.1122.623.024.0Any update
21.1222.723.124.0Any update
21.1322.823.224.0Any update
21.1422.923.324.0Any update
21.1522.1023.424.0Any update
21.1622.1123.524.0Any update
21.1722.1223.624.0Any update
21.1822.1323.724.1Any update

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.

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.

Version 20Version 21Version 22Version 23Version 24 and 25
20.0 to 20.521.022.023.0Any update
20.621.122.023.0Any update
20.721.222.023.0Any update
20.821.322.023.0Any update
20.921.422.023.0Any update
20.1021.522.023.0Any update
20.1121.622.023.0Any update
20.1221.722.123.0Any update
20.1321.822.223.0Any update
20.1421.922.323.0Any update
20.1521.1022.423.0Any update
20.1621.1122.523.0Any update
20.1721.1222.623.0Any update
20.1821.1322.723.1Any update

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.

Version 19Version 20Version 21Version 22Version 23 through 25
19.0 to 19.520.021.022.0Any update
19.620.121.022.0Any update
19.720.221.022.0Any update
19.820.321.022.0Any update
19.920.421.022.0Any update
19.1020.521.022.0Any update
19.1120.621.022.0Any update
19.1220.721.122.0Any update
19.1320.821.222.0Any update
19.1420.921.322.0Any update
19.1520.1021.422.0Any update
19.1620.1121.522.0Any update
19.1720.1221.622.0Any update
19.18[1]20.1321.722.1Any update

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.

Version 18Version 19Version 20Version 21Version 22 through 25
18.0 to 18.519.020.021.0Any update
18.619.120.021.0Any update
18.719.220.021.0Any update
18.819.320.021.0Any update
18.919.420.021.0Any update
18.1019.520.021.0Any update
18.1119.620.021.0Any update
18.1219.720.121.0Any update
18.1319.820.221.0Any update
18.1419.920.321.0Any update
18.1519.1020.421.0Any update
18.1619.1120.521.0Any update
18.1719.1220.621.0Any update
18.1819.1320.721.1Any update

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

Note

This release wave isn't updated anymore.

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.

Version 17Version 18Version 19Version 20Version 21 through 25
17.0 to 17.518.019.020.0Any update
17.618.119.020.0Any update
17.718.319.020.0Any update
17.818.419.020.0Any update
17.918.519.020.0Any update
17.1018.619.020.0Any update
17.1118.719.120.0Any update
17.1218.819.220.0Any update
17.1318.919.320.0Any update
17.1418.1019.420.0Any update
17.1518.1119.520.0Any update
17.1618.1219.620.0Any update
17.1718.1319.720.1Any update

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.

Version 16Version 17Version 18Version 19Version 20 through 25
16.0 to 16.517.018.019.0Any update
16.617.118.019.0Any update
16.717.218.019.0Any update
16.817.318.019.0Any update
16.917.418.019.0Any update
16.1017.518.019.0Any update
16.1117.618.019.0Any update
16.1217.718.119.0Any update
16.1317.818.319.0Any update
16.1417.918.419.0Any update
16.1517.1018.519.0Any update
16.1617.1118.619.0Any update
16.1717.1218.719.1Any update

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.

Version 15Version 16Version 17Version 18Version 19 through 25
15.0 to 15.416.017.018.0Any update
15.516.117.018.0Any update
15.616.217.018.0Any update
15.716.317.018.0Any update
15.816.417.018.0Any update
15.916.517.018.0Any update
15.1016.617.018.0Any update
15.1116.717.118.0Any update
15.1216.817.218.0Any update
15.1316.917.318.0Any update
15.1416.1017.418.0Any update
15.1516.1117.518.0Any update
15.1616.1217.618.0Any update
15.1716.1317.718.1Any update

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.

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 14Version 15Version 16Version 17Version 18Version 19Version 20Version 21Version 22Version 23Version 24 and 25
14.0 (GA and cumulative update 01)15.016.017.018.019.020.021.022.023.0Any update
14.3 (cumulative update 02)15.016.017.018.019.020.021.022.023.0Any update
14.4 (cumulative update 03)15.016.017.018.019.020.021.022.023.0Any update
14.5 (cumulative update 04)15.016.017.018.019.020.021.022.023.0Any update
14.6 (cumulative update 05)15.116.017.018.019.020.021.022.023.0Any update
14.7 (cumulative update 06)15.216.017.018.019.020.021.022.023.0Any update
14.8 (cumulative update 07)15.316.017.018.019.020.021.022.023.0Any update
14.9 (cumulative update 08)15.316.017.018.019.020.021.022.023.0Any update
14.10 (cumulative update 09)15.416.017.018.019.020.021.022.023.0Any update
14.11 (cumulative update 10)15.516.017.018.019.020.021.022.023.0Any update
14.12 (cumulative update 11)15.616.117.018.019.020.021.022.023.0Any update
14.13 (cumulative update 12)15.716.217.018.019.020.021.022.023.0Any update
14.14 (cumulative update 13)15.816.317.018.019.020.021.022.023.0Any update
14.15 (cumulative update 14)15.916.417.018.019.020.021.022.023.0Any update
14.16 (cumulative update 15)15.1016.517.018.019.020.021.022.023.0Any update
14.17 (cumulative update 16)15.1116.617.018.019.020.021.022.023.0Any update
14.18 (cumulative update 17)15.1216.717.118.019.020.021.022.023.0Any update
14.19 (cumulative update 18)15.1316.817.218.019.020.021.022.023.0Any update
14.20 (cumulative update 19)15.1416.917.318.019.020.021.022.023.0Any update
14.21 (cumulative update 20)15.1516.1017.418.019.020.021.022.023.0Any update
14.22 (cumulative update 21)15.1616.1117.518.019.020.021.022.023.0Any update
14.23 (cumulative update 22)15.1716.1217.618.019.020.021.022.023.0Any update
14.24 (cumulative update 23)None16.1317.718.119.020.021.022.023.0Any update
14.25 (cumulative update 24)None16.1417.818.319.020.021.022.023.0Any update
14.26 (cumulative update 25)None16.1517.918.419.020.021.022.023.0Any update
14.27 (cumulative update 26)None16.1617.1018.519.020.021.022.023.0Any update
14.28 (cumulative update 27)None16.1717.1118.619.020.021.022.023.0Any update
14.29 (cumulative update 28)None16.1817.1218.719.120.021.022.023.0Any update
14.30 (cumulative update 29)NoneNone17.1318.819.220.021.022.023.0Any update
14.31 (cumulative update 30)NoneNone17.1418.919.320.021.022.023.0Any update
14.32 (cumulative update 31)NoneNone17.1518.1019.420.021.022.023.0Any update
14.33 (cumulative update 32)NoneNone17.1618.1119.520.021.022.023.0Any update
14.34 (cumulative update 33)NoneNone17.718.1219.620.021.022.023.0Any update
14.35 (cumulative update 34)NoneNone17.1818.1319.720.121.022.023.0Any update
14.36 (cumulative update 35)NoneNoneNone18.1419.820.221.022.023.0Any update
14.37 (cumulative update 36)NoneNoneNone18.1519.920.321.022.023.0Any update
14.38 (cumulative update 37)NoneNoneNone18.1619.1020.421.022.023.0Any update
14.39 (cumulative update 38)NoneNoneNone18.1719.1120.521.022.023.0Any update
14.40 (cumulative update 39)NoneNoneNone18.1819.1220.621.022.023.0Any update
14.41 (cumulative update 40)NoneNoneNoneNone19.1320.721.122.023.0Any update
14.42 (cumulative update 41)NoneNoneNoneNone19.1420.821.222.023.0Any update
14.43 (cumulative update 42)NoneNoneNoneNone19.520.921.322.023.0Any update
14.44 (cumulative update 43)NoneNoneNoneNone19.1620.1021.422.023.0Any update
14.45 (cumulative update 44)NoneNoneNoneNone19.1720.1121.522.023.0Any update
14.46 (cumulative update 45)NoneNoneNoneNone19.1820.1221.622.023.0Any update
14.47 (cumulative update 46)NoneNoneNoneNoneNone20.1321.722.123.0Any update
14.48 (cumulative update 47)NoneNoneNoneNoneNone20.1421.822.223.0Any update
14.49 (cumulative update 48)NoneNoneNoneNoneNone20.1521.922.323.0Any update
14.50 (cumulative update 49)NoneNoneNoneNoneNone20.1621.1022.423.0Any update
14.51 (cumulative update 50)NoneNoneNoneNoneNone20.1721.1122.523.0Any update
14.52 (cumulative update 51)NoneNoneNoneNoneNone20.1821.1222.623.0Any update
14.53 (cumulative update 52)NoneNoneNoneNoneNoneNone21.1322.723.1Any update

Note

If a link to an update isn't working, it's due to a delay in the on-premise release. However, the update will be available soon. Please check back in a couple of 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