---
id: topic/dev-itpro/business-central-on-premises/upgrade/earlier-versions/business-central-2023-release-wave-2
type: topic
title: Business Central 2023 release wave 2
summary: "Upgrade guidance for on-premises Business Central 2023 release wave 2 (version 23): upgrade paths from versions 14 through 22, technical upgrade steps, C/AL to AL conversion, moving tables between extensions, permissions and report changes. It answers how to upgrade to version 23 and what to prepare first."
tier: official
language: en
system: platform
review:
  state: reviewed
  by: opus
  at: "2026-10-07T02:17:46.314Z"
  flags: []
generated:
  at: "2026-10-08T00:04:31.553Z"
  pipeline: 0.2.0
  prompts:
    hub-topic: 1
  input_hash: 3f441b57228e8ad4197655a2ddb808235aa03523edcbcaf760adbbc596e74396
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-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/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-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/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-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-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/upgrade-technical-upgrade-v23
    title: Technical Upgrade to Version 23
    date: "2023-11-27"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v23
    title: Upgrade to Business Central 2023 Wave 2
    date: "2023-08-14"
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v23
    title: Upgrading Customized C/AL Application to Microsoft Base Application for 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-unmodified-application-to-v23
    title: Upgrading Microsoft System and Base Application to Version 23
    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-v23
    title: Upgrading Unmodified C/AL Application to version 23
    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-v23
    - 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-v23
    - 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-v23
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v23
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v23
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v23
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v23
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v23
    - 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-v23
  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 2023 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: 36dd0cb723aafbb1ce8815e545447a5c239af88318275752ce3b1de19065fd19
narrative: generated
---

# Business Central 2023 release wave 2

> Upgrade guidance for on-premises Business Central 2023 release wave 2 (version 23): upgrade paths from versions 14 through 22, technical upgrade steps, C/AL to AL conversion, moving tables between extensions, permissions and report changes. It answers how to upgrade to version 23 and what to prepare first.

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

## Overview

This section collects the Learn pages for upgrading on-premises Business Central to 2023 release wave 2 (version 23). It starts with an overview page covering upgrade paths, deprecated features and on-premises to online migration, plus a general considerations page and a compatibility matrix that shows the minimum versions needed between major versions.

The technical upgrade pages are split by starting version: one for version 14, one for version 19, and one for versions 20, 21 and 22. Separate pages cover upgrading the Microsoft System and Base Application from versions 15-22, and upgrading a version 14 C/AL application, either unmodified or customized. Each covers database conversion, extension publishing and synchronization. A page on installing a version 23 update covers platform and application updates with PowerShell.

Supporting pages handle specific work: C/AL to AL conversion with Txt2Al, moving tables and fields between extensions (up or down the dependency graph with migration.json), upgrading permission sets, and upgrading reports. Start with the overview and compatibility matrix, then choose the technical upgrade page for your starting version.

## Key points

- The compatibility matrix lists minimum update versions for upgrades between major versions; upgrades from version 24 or earlier must target version 25 first.
- Separate technical upgrade guides exist for version 14, version 19, and versions 20-22 to version 23.
- Upgrading a version 14 C/AL application to version 23 uses the System and Base Application extensions, with the DestinationAppsForMigration setting and migration.json for table migration.
- Customized C/AL code is converted to AL with the Txt2Al tool, including .NET interoperability and test library conversion.
- Moving tables and fields down the dependency graph uses migration.json; moving up requires a two-stage process with a transition extension.
- Permission sets move from legacy data-based permissions to AL object-based Permission Set and Permission Set Extension objects.
- Report upgrade guidance for version 20 and later covers the new platform rendering model, report events, and Word and RDLC custom layouts.
- The India Data Migration Toolkit page covers NAV 2016 India to Business Central 2021 release wave 2 in two steps, without customizations.

## 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](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-considerations-v23): This article provides tips and considerations to prepare a solution when you're planning to upgrade to Business Central 2023 release wave 2 and later.
- [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 23 update](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrading-cumulative-update-v23): This article describes the tasks required for getting the monthly version 23 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 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v14-v23): Describes how to do a technical upgrade from Business Central 14 to 23.
- [Technical Upgrade From Version 19 to Version 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v19-to-v23): Describes how to do a technical upgrade from Business Central V19 to V23
- [Technical Upgrade to Version 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-technical-upgrade-v23): Describes how to do a technical upgrade from Business Central V19, V20, V21, V22 to V23
- [Upgrade to Business Central 2023 Wave 2](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-overview-v23): Provides an overview of Business Central 2023 Release Wave 2 upgrade.
- [Upgrading Customized C/AL Application to Microsoft Base Application for version 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-to-microsoft-base-app-v23): Describes how to do an upgrade from a customized Business Central 14 to Microsoft Base Application for version 23.
- [Upgrading Microsoft System and Base Application to Version 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-to-v23): Describes how to upgrade an unmodified Business Central versions 15 through 22 to version 23
- [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 23](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/upgrade/upgrade-unmodified-application-v14-v23): Describes how to upgrade an unmodified Business Central 14 application to version 23

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