Upgrade

Path: Business Central on-premises > Upgrade · tier official · system platform · narrative reviewed (checked by Opus)

Overview

This section covers moving an on-premises Business Central deployment to a newer release. Three pages sit at the top level: an overview of upgrading to Business Central (online or on-premises, including help migration and multitenancy migration), a matrix of supported upgrade paths, and a list of known issues for installation, upgrade and operations.

Detailed procedures are split by release. The v26 to v29 subtopics cover upgrade paths, pre-upgrade considerations for v26 and later, the upgrade steps from earlier versions, and installing an update of that version. The v25 subtopic covers upgrade paths, installing a v25 update, report and permission changes, and application and data upgrade steps. Earlier versions (v14 through v24) are grouped in one subtopic. A Related articles subtopic covers Txt2Al conversion of version 14 C/AL code to AL and migrating tables and fields between extensions with migration.json.

Start with the supported upgrade paths page to see whether your source version can reach the target directly or needs intermediate versions. Then open the subtopic for the target release, read any pre-upgrade considerations, and follow the upgrade steps.

Key points

• The supported paths page shows direct and indirect routes from v14 (Spring 2019) to v29 (2026 wave 2).
• Direct upgrade from v14 to the latest is not supported from v26 onwards; v14 must route through v25.
• The v29 guide covers upgrading from versions 25, 26, 27 or 28 and installing a v29 update.
• The v28 guide covers upgrading from versions 25, 26 or 27 and installing a v28 update.
• The v27 and v26 guides cover upgrade paths, pre-upgrade considerations, installing updates and upgrading the System and Base Application.
• The v25 guide covers upgrade paths, installing a v25 update, report and permission changes, and application and data upgrade steps.
• Known issues cover PowerShell module failures, evaluation company creation, web server installation, extension sync errors and NavUserPassword authentication.
• Related articles cover Txt2Al conversion of version 14 C/AL code to AL, migration.json table moves between extensions, and the India Data Migration Toolkit.

Subtopics

• Business Central 2026 release wave 2 (v29) (4 pages)
• Business Central 2026 release wave 1 (v28) (4 pages)
• Business Central 2025 release wave 2 (v27) (4 pages)
• Business Central 2025 release wave 1 (v26) (4 pages)
• Business Central 2024 release wave 2 (v25) (8 pages)
• Earlier versions (92 pages)
• Related articles (5 pages)

More Learn pages

• Some Known Issues in Business Central On-premises: Provides an overview of the known issues that can affect Business Central installation or upgrade.
• Supported upgrade paths to Business Central on-premises: Provides an overview of the different upgrade paths for Business Central on-premises across versions.
• Upgrading to Dynamics 365 Business Central: Learn how to upgrade to Dynamics 365 Business Central with this comprehensive guide. Covers online and on-premises deployment options.

Videos, posts and code changes

Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.

• #12307 Make UpgradeDefaultDimensions ParentId backfill set-based (via DataTransfer) (code change): “UpgradeDefaultDimensions procedure now uses set-based DataTransfer operations”
• June 2026 Cumulative Updates for Dynamics 365 Business Central (community post): “cumulative update links for Business Central on-premises: 28.2, 27.8 and 26.14”
• July 2026 Cumulative Updates for Dynamics 365 Business Central (community post): “July 2026 cumulative updates are available for Dynamics 365 Business Central”
• August 2026 Cumulative Updates for Dynamics 365 Business Central (community post): “August 2026 cumulative updates are available for Dynamics 365 Business Central”
• September 2026 Cumulative Updates for Dynamics 365 Business Central (community post): “September 2026 cumulative updates are available for Dynamics 365 Business Central”
• (2025 MAY) Cumulative Updates for Business Central (community post): “Cumulative updates for Business Central replace previously released updates”
• (2025 JUL) Cumulative Updates for Business Central (community post): “Cumulative updates for Business Central replace previous updates and fix vulnerabilities”
• (2025 AUG) Cumulative Updates for Business Central (community post): “latest Business Central cumulative updates: 26.4 for 2025 release wave 1”
• (2025 SEP) Cumulative Updates for Business Central (community post): “latest Business Central cumulative updates: 26.5 for v26 (2025 release wave 1)”
• (2025 OCT) Cumulative Updates for Business Central (community post): “Lists the latest cumulative updates for Business Central: 26.6 for v26”
• (2025 NOV) Cumulative Updates for Business Central (community post): “Cumulative updates for Business Central replace previously released updates for each version”
• Cumulative Updates for Business Central – versions (community post): “Lists links to cumulative update pages for Business Central on-premises”

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.