Earlier versions
Earlier versions covers on-premises Business Central upgrade documentation for each release from spring 2019 (v.14) through 2024 release wave 1 (version 24). It answers which upgrade paths exist to a given version, how to run the technical upgrade, convert C/AL to AL, move tables between extensions, and install updates.
Path: Business Central on-premises > Upgrade > Earlier versions · tier official · system platform · narrative reviewed (checked by Opus)
Overview
This section holds one subtopic per release, from Business Central spring 2019 (v.14) to 2024 release wave 1 (version 24). Each subtopic is a self-contained set of upgrade pages for that target version, so pick the one that matches the version you are upgrading to.
Key points
- Each release has its own upgrade set: v.14 (spring 2019), 15, 16, 17, 18, 19, 20, 21, 22, 23 and 24.
- Subtopics list the supported upgrade paths to that version, for example versions 14 through 22 for version 23, and C/AL (version 14) or versions 15-23 for version 24.
- Later releases cover technical upgrade steps, with separate paths for unmodified and customized C/AL from version 14 (shown for version 21).
- C/AL to AL conversion is covered, with Txt2Al named in the version 17 and 19 pages.
- Moving tables and fields between extensions is covered, with migration.json named in the version 16, 17 and 19 pages.
- Most subtopics include a compatibility matrix for upgrade paths and minimum versions, and several cover installing cumulative updates for that version.
- Permission set and report changes are covered in the later releases, and the version 19 pages add the India data migration toolkit.
- The spring 2019 (v.14) pages cover technical upgrade, code merging, single-tenant and multitenant data upgrade, and codeunit 1 replacement.
Subtopics
- Business Central 2024 release wave 1 (14 pages)
- Business Central 2023 release wave 2 (17 pages)
- Business Central 2023 release wave 1 (15 pages)
- Business Central 2022 release wave 2 (17 pages)
- Business Central 2022 release wave 1 (15 pages)
- Business Central 2021 release wave 2 (14 pages)
- Business Central 2021 release wave 1 (13 pages)
- Business Central 2020 release wave 2 (14 pages)
- Business Central 2020 release wave 1 (13 pages)
- Business Central 2019 release wave 2 (5 pages)
- Business Central spring 2019 (10 pages)
Business Central pages and reports
The pages, reports and queries this hub’s Learn pages name (ms.search.form, API reference), joined to the code by exact object id (data/index/docs-objects.json); a page shows the table it runs on.
Learn also names 1 object with no object page: page/19010.
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.
What Learn documents here 8 of 92 Learn pages
- learnBusiness Central Upgrade Compatibility Matrix2026-10-01
- learnCode Conversion from C/AL to AL2021-04-01
- learnConverting a Database to Dynamics 365 Business Central - Technical Upgrade2024-04-18
- learnDestinationAppsForMigration2024-04-18
- learnGeneral Information and Considerations When Upgrading to Business Central2024-09-02
- learnGeneral Information and Considerations When Upgrading to Business Central 2022 Release Wave 22024-04-18
- learnGeneral Information and Considerations When Upgrading to Business Central 2023 Release Wave 12021-04-01
- learnIndia Data migration Toolkit Overview2022-02-18
Show 32 more
- learnInstall a cumulative update2024-04-18
- learnInstall a version 15 update2024-04-18
- learnInstall a version 16 update2024-04-18
- learnInstall a version 17 update2024-04-18
- learnInstall a version 18 update2024-04-18
- learnInstall a version 19 update2024-04-18
- learnInstall a version 20 update2024-04-18
- learnInstall a version 21 update2024-01-04
- learnInstall a version 22 update2023-02-09
- learnInstall a version 23 update2023-12-18
- learnInstall a version 24 update2024-07-24
- learnMigrating Tables and Fields Between Extensions2021-04-01
- learnMoving Tables and Fields to Extensions Down the Dependency Graph2021-04-01
- learnMoving Tables and Fields to Extensions Up the Dependency Graph2021-04-01
- learnMultitenant Technical Upgrade Quick Reference2024-04-18
- learnSingle-Tenant Full Upgrade Quick Reference2024-04-18
- learnTechnical Upgrade2024-04-18
- learnTechnical Upgrade From Version 14 to Version 162024-04-18
- learnTechnical Upgrade From Version 14 to Version 172024-04-18
- learnTechnical Upgrade From Version 14 to Version 182024-04-18
- learnTechnical upgrade From version 14 to version 192024-04-18
- learnTechnical Upgrade From Version 14 to Version 202024-04-18
- learnTechnical Upgrade From Version 14 to Version 212024-04-18
- learnTechnical Upgrade From Version 14 to Version 222024-04-18
- learnTechnical upgrade from version 14 to version 232023-08-14
- learnTechnical upgrade from version 15 to version 162024-04-18
- learnTechnical Upgrade from Version 15 to Version 172024-04-18
- learnTechnical Upgrade from Version 16 to Version 172024-04-18
- learnTechnical Upgrade from Version 17 to Version 182024-04-18
- learnTechnical Upgrade From Version 18 or 19 to Version 212024-04-18
- learnTechnical Upgrade From Version 19 to Version 232023-08-14
- learnTechnical Upgrade Quick Reference2024-04-18