---
id: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions
type: topic
title: Earlier versions
summary: 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.
tier: official
language: en
system: platform
review:
  state: reviewed
  by: opus
  at: "2026-10-07T05:20:49.753Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: 7398176ee60cba32ce7c5de749086cb136b070cec4f6b6fbdd71f4b6269cc17f
evidence:
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility
    title: Business Central Upgrade Compatibility Matrix
    date: "2026-10-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion
    title: Code Conversion from C/AL to AL
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/Converting-a-Database
    title: Converting a Database to Dynamics 365 Business Central - Technical Upgrade
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-destinationappsformigration
    title: DestinationAppsForMigration
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v23
    title: General Information and Considerations When Upgrading to Business Central
    date: "2024-09-02"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v21
    title: General Information and Considerations When Upgrading to Business Central 2022 Release Wave 2
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v22
    title: General Information and Considerations When Upgrading to Business Central 2023 Release Wave 1
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview
    title: India Data migration Toolkit Overview
    date: "2022-02-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update
    title: Install a cumulative update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v15
    title: Install a version 15 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v16
    title: Install a version 16 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v17
    title: Install a version 17 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v18
    title: Install a version 18 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v19
    title: Install a version 19 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v20
    title: Install a version 20 update
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v21
    title: Install a version 21 update
    date: "2024-01-04"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v22
    title: Install a version 22 update
    date: "2023-02-09"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v23
    title: Install a version 23 update
    date: "2023-12-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v24
    title: Install a version 24 update
    date: "2024-07-24"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields
    title: Migrating Tables and Fields Between Extensions
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down
    title: Moving Tables and Fields to Extensions Down the Dependency Graph
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up
    title: Moving Tables and Fields to Extensions Up the Dependency Graph
    date: "2021-04-01"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/multitenant-upgrade-checklist
    title: Multitenant Technical Upgrade Quick Reference
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/singletenant-upgrade-checklist
    title: Single-Tenant Full Upgrade Quick Reference
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v15
    title: Technical Upgrade
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v16
    title: Technical Upgrade From Version 14 to Version 16
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v17
    title: Technical Upgrade From Version 14 to Version 17
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v18
    title: Technical Upgrade From Version 14 to Version 18
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v19
    title: Technical upgrade From version 14 to version 19
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v20
    title: Technical Upgrade From Version 14 to Version 20
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v21
    title: Technical Upgrade From Version 14 to Version 21
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v22
    title: Technical Upgrade From Version 14 to Version 22
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v23
    title: Technical upgrade from version 14 to version 23
    date: "2023-08-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v15-v16
    title: Technical upgrade from version 15 to version 16
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v15-v17
    title: Technical Upgrade from Version 15 to Version 17
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v16-v17
    title: Technical Upgrade from Version 16 to Version 17
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v18
    title: Technical Upgrade from Version 17 to Version 18
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v21
    title: Technical Upgrade From Version 18 or 19 to Version 21
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v23
    title: Technical Upgrade From Version 19 to Version 23
    date: "2023-08-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/technical-upgrade-checklist
    title: Technical Upgrade Quick Reference
    date: "2024-04-18"
    commit: null
    t: null
    quote: null
links:
  learn: []
  objects: []
  features: []
  topics:
    - topic/dev-itpro/business-central-on-premises/upgrade
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2024-release-wave-1
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2023-release-wave-2
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2023-release-wave-1
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2022-release-wave-2
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2022-release-wave-1
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2021-release-wave-2
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2021-release-wave-1
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2020-release-wave-2
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2020-release-wave-1
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2019-release-wave-2
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-spring-2019
  localizations: []
  videos: []
  posts: []
  guidelines: []
learn_toc_path:
  - Business Central on-premises
  - Upgrade
  - Earlier versions
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/business-central-on-premises/upgrade
children:
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2024-release-wave-1
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2023-release-wave-2
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2023-release-wave-1
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2022-release-wave-2
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2022-release-wave-1
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2021-release-wave-2
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2021-release-wave-1
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2020-release-wave-2
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2020-release-wave-1
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2019-release-wave-2
  - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-spring-2019
coverage:
  learn: 92
  code: 0
  video: 0
  blog: 0
  guideline: 0
bc_forms:
  - 19010
member_hash: c25662c24e4f75e835aa6e1b2ce71c7d5b75ebc62db6e4516e375d4c694e31ec
narrative: generated
---

# 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](../../business-central-on-premises.md) > [Upgrade](../upgrade.md) > 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](earlier-versions/business-central-2024-release-wave-1.md) (14 pages)
- [Business Central 2023 release wave 2](earlier-versions/business-central-2023-release-wave-2.md) (17 pages)
- [Business Central 2023 release wave 1](earlier-versions/business-central-2023-release-wave-1.md) (15 pages)
- [Business Central 2022 release wave 2](earlier-versions/business-central-2022-release-wave-2.md) (17 pages)
- [Business Central 2022 release wave 1](earlier-versions/business-central-2022-release-wave-1.md) (15 pages)
- [Business Central 2021 release wave 2](earlier-versions/business-central-2021-release-wave-2.md) (14 pages)
- [Business Central 2021 release wave 1](earlier-versions/business-central-2021-release-wave-1.md) (13 pages)
- [Business Central 2020 release wave 2](earlier-versions/business-central-2020-release-wave-2.md) (14 pages)
- [Business Central 2020 release wave 1](earlier-versions/business-central-2020-release-wave-1.md) (13 pages)
- [Business Central 2019 release wave 2](earlier-versions/business-central-2019-release-wave-2.md) (5 pages)
- [Business Central spring 2019](earlier-versions/business-central-spring-2019.md) (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.