{"title":"Upgrading to Dynamics 365 Business Central 2024 release wave 2","url":"https://jonas-paprotka.de/docs/dev-itpro/upgrade/upgrade-overview-v25/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v25, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v25","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Provides an overview of Business Central 2024 Release Wave 2 upgrade process.","date":"2024-02-09","meta":{"topic":"overview"},"outline":[{"level":1,"title":"Upgrading to Dynamics 365 Business Central 2024 release wave 2","slug":"upgrading-to-dynamics-365-business-central-2024-release-wave-2","at":0,"chars":4504},{"level":2,"title":"Upgrade path","slug":"upgrade-path","at":748,"chars":1510},{"level":2,"title":"Upgrade overview","slug":"upgrade-overview","at":2258,"chars":575},{"level":2,"title":"New and changed features","slug":"new-and-changed-features","at":2833,"chars":910},{"level":3,"title":"Business Foundation extension","slug":"business-foundation-extension","at":3221,"chars":522},{"level":2,"title":"Deprecated features","slug":"deprecated-features","at":3743,"chars":341},{"level":2,"title":"Migrating from on-premises to online","slug":"migrating-from-on-premises-to-online","at":4084,"chars":237},{"level":2,"title":"Related information","slug":"related-information","at":4321,"chars":183}],"text":"# Upgrading to Dynamics 365 Business Central 2024 release wave 2\nBusiness Central 2024 Release wave 2 (version 25) is the 11th major release that is fully AL-based. Business Central 2019 release wave 2 (version 15) marked the release in which C/AL was replaced by AL. The classic development environment, known as C/SIDE, was deprecated. From an application perspective, Business Central is now extension-based only. The Business Central base application is delivered as an AL extension. Also, application functionality that isn't related to the business logic has moved into separate modules. These modules are combined into an extension known as the System Application. This change influences how you do the upgrade compared to earlier releases.\n## Upgrade path\nDepending on your current version, a direct upgrade to version 25 isn't always possible. You might have to first upgrade to an intermediate version. The following table describes the upgrade paths for supported versions:\nSource version|Path\n<ul><li> Microsoft Dynamics NAV 2015 (version 8)</li><li>Microsoft Dynamics NAV 2016 (version 9)</li><li>Microsoft Dynamics NAV 2017 (version 10)</li><li>Microsoft Dynamics NAV 2018 (version 11)</li><li>Business Central October 2018 (version 13)</li></ul>|<ol><li>Business Central Spring 2019 (version 14)</li><li>Business Central 2024 release wave 2 (version 25)</li></ol>This path requires you convert your application from C/AL to AL.\n<ul><li> Business Central Spring 2019 (version 14)</li><li> Business Central 2019 Release Wave 2 (version 15)</li><li> Business Central 2020 release wave 1 (version 16)</li><li> Business Central 2020 release wave 2 (version 17)</li><li> Business Central 2021 release wave 1 (version 18)</li><li> Business Central 2021 release wave 2 (version 19)</li><li> Business Central 2022 release wave 1 (version 20)</li><li>Business Central 2022 release wave 2 (version 21)</li><li>Business Central 2023 release wave 1 (version 22)</li><li>Business Central 2023 release wave 2 (version 23)</li><li>Business Central 2024 release wave 1 (version 24)</li></ul>|Direct to version 25\nYour current version doesn't have to be the latest update for the version. However, for intermediate versions, use to the latest available update.\n## Upgrade overview\nWhen upgrading your Business Central Spring 2019 (version 14) solution to version 25, the goal is to move towards a full uptake of the Business Central base and system applications, as they are, and migrating code customizations to add-on extensions. There are different upgrade levels that you follow to get to this state, as illustrated in the following figure. We recommend that you refactor to the system application as a minimum.\n<https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/media/bc25-upgrade-paths-v1.svg#lightbox>\n## New and changed features\nThere are several new and changed platform and application features available in Business Central 2024 release wave 2. These changes affect users, administrators, and developers. See Overview of Dynamics 365 Business Central 2024 Release Wave 2<https://learn.microsoft.com/dynamics365/release-plan/2024wave2/smb/dynamics365-business-central/planned-features>.\n### Business Foundation extension\nThis extension is introduced in version 25 and currently contains objects and logic for number series, which was previously part of the base application. It will contain more functionality in future releases. The base application now has a dependency on the business foundation extension in addition to the system application. This change affects the upgrade process because the business foundation extension needs to be published and installed on the tenant before the base application.\n## Deprecated features\nBefore you upgrade, review the following articles to get an overview of features deprecated in this release:\n deprecated-features-w1\n deprecated-features-platform\n deprecated-tables\nFrom these articles, use the links in the table of contents to view more deprecated features, like features specific to local versions.\n## Migrating from on-premises to online\nFor information about migrating an on-premises solution to online, see Migrate to Business Central Online from Business Central On-premises<../administration/migrate-business-central-on-premises>.\n## Related information\nupgrading-to-business-central\n../developer/devenv-upgrading-extensions\nDynamics 365 Business Central Upgrade Compatibility Matrix<upgrade-v14-v15-compatibility>"}