---
id: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2022-release-wave-2
type: topic
title: Business Central 2022 release wave 2
summary: Upgrade guidance for on-premises Business Central 2022 release wave 2 (version 21). It covers upgrade paths from version 14 (unmodified or customized C/AL), versions 15-20, versions 18/19 and version 20, plus C/AL to AL conversion, permission and report changes, moving tables between extensions, and installing version 21 updates. Use it for how-to and upgrade path questions about these upgrades.
tier: official
language: en
system: platform
review:
  state: reviewed
  by: opus
  at: "2026-10-07T02:17:44.262Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: 14f9ce89318c81575bf5cfcb7aa9237be37e0f2e827df98a1c81a93bec2aca44
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/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/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-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/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/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-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-v21
    title: Technical Upgrade 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-overview-v21
    title: Upgrade to Business Central 2022 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-to-microsoft-base-app-v21
    title: Upgrading Customized C/AL Application to Microsoft Base Application for version 21
    date: "2022-03-05"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v21
    title: Upgrading Microsoft System and Base Application to Version 21
    date: "2024-01-18"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions
    title: Upgrading Permission Sets and Permissions
    date: "2026-01-08"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-reports
    title: Upgrading Reports
    date: "2022-08-31"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v21
    title: Upgrading Unmodified C/AL Application to Version 21
    date: "2024-01-18"
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v21
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-reports
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v21
  objects: []
  features: []
  topics:
    - topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions
  localizations: []
  videos: []
  posts: []
  guidelines: []
learn_toc_path:
  - Business Central on-premises
  - Upgrade
  - Earlier versions
  - Business Central 2022 release wave 2
toc_file: dev-itpro/TOC.md
parent: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions
children: []
coverage:
  learn: 17
  code: 0
  video: 0
  blog: 0
  guideline: 0
bc_forms:
  - 19010
member_hash: b12a7a6b5aa524b7355d62c849a07e438a6a8f0c9ef0f3f29f81bef8baae7b33
narrative: generated
---

# Business Central 2022 release wave 2

> Upgrade guidance for on-premises Business Central 2022 release wave 2 (version 21). It covers upgrade paths from version 14 (unmodified or customized C/AL), versions 15-20, versions 18/19 and version 20, plus C/AL to AL conversion, permission and report changes, moving tables between extensions, and installing version 21 updates. Use it for how-to and upgrade path questions about these upgrades.

Path: [Business Central on-premises](../../../business-central-on-premises.md) > [Upgrade](../../upgrade.md) > [Earlier versions](../earlier-versions.md) > Business Central 2022 release wave 2 · tier official · system platform · narrative reviewed (checked by Opus)

## Overview

This section collects the pages for upgrading to Business Central 2022 release wave 2 (version 21) on-premises. The entry page, "Upgrade to Business Central 2022 Wave 2", describes the two options: a technical upgrade or application refactoring. "General Information and Considerations" lists what changes in this release, such as the permissions model, report platform, and server configuration. The section also includes an India Data Migration Toolkit page, which covers a different target: moving from Dynamics NAV 2016 India to 2021 release wave 2.

## Key points

- Start with 'Upgrade to Business Central 2022 Wave 2' and the general considerations page, then pick the path matching your source version.
- Technical upgrade pages exist for version 14, versions 18 or 19, and version 20 to version 21; a separate page covers versions 15-20 for the Microsoft System and Base Application.
- Version 14 C/AL paths split into unmodified and customized applications; both use DestinationAppsForMigration, and the customized path adds table migration with migration.json and Txt2Al conversion to AL.
- Permissions move from legacy data-based permissions to AL object-based Permission Set and Permission Set Extension objects.
- Report guidance for version 20 and later covers the platform rendering model, report events, and handling of Word and custom report layouts.
- Moving tables and fields between extensions uses migration.json, and the direction (down or up the dependency graph) decides the process; moving up needs a two-stage deployment with a transition extension.
- The 'Install a version 21 update' page covers cumulative updates with PowerShell tasks: platform conversion, database sync, extension repair, data upgrade, license import, control add-in upgrade.
- The compatibility matrix shows minimum update versions for upgrade paths; upgrades from version 24 or earlier must target version 25 first.

## Learn pages

- [Business Central Upgrade Compatibility Matrix](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-v14-v15-compatibility): Provides an overview of the Business Central versions and their compatibility
- [Code Conversion from C/AL to AL](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/devenv-code-conversion): Description of the conversion process from C/AL to AL.
- [General Information and Considerations When Upgrading to Business Central 2022 Release Wave 2](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v21): This article provides tips and considerations to prepare a solution when you're planning to upgrade to Business Central 2022 release wave 2.
- [India Data migration Toolkit Overview](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/india-data-migration-toolkit-overview): Specifies India Data Migration Toolkit Overview
- [Install a version 21 update](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v21): This article describes the tasks required for getting the monthly version 21 update applied to your Dynamics 365 Business Central on-premises.
- [Migrating Tables and Fields Between Extensions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields): Explains how to migrate tables and fields from one extension to another.
- [Moving Tables and Fields to Extensions Down the Dependency Graph](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-down): Explains how to move tables and fields from an extension to another extension that is down the dependency graph.
- [Moving Tables and Fields to Extensions Up the Dependency Graph](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-migrate-table-fields-up): Explains how to move tables and fields from an extension to another extension that is up the dependency graph
- [Technical Upgrade From Version 14 to Version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v21): Describes how to do a technical upgrade from Business Central 14 to 21
- [Technical Upgrade From Version 18 or 19 to Version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v21): Describes how to do a technical upgrade from Business Central V18 and V19 to V21
- [Technical Upgrade to Version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v21): Describes how to do a technical upgrade from Business Central V18, V19, V20 to V21
- [Upgrade to Business Central 2022 Wave 2](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v21): Provides an overview of Business Central 2022 release wave 2 upgrade
- [Upgrading Customized C/AL Application to Microsoft Base Application for version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v21): Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 21.
- [Upgrading Microsoft System and Base Application to Version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v21): Describes how to upgrade an unmodified Business Central versions 15, 16, 17, 18, 19, or 20 to version 21
- [Upgrading Permission Sets and Permissions](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-permissions): Describes how to upgrade permissions and permission sets
- [Upgrading Reports](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-reports): Describes how to upgrade reports
- [Upgrading Unmodified C/AL Application to Version 21](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v21): Describes how to upgrade an unmodified Business Central 14 application to version 21

## 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.