topic hubPlatform, DevOps & Performanceofficial - Microsoftreviewed - checked by Opus

Business Central 2026 release wave 1 (v28)

Upgrading Business Central on-premises to 2026 release wave 1 (version 28). It covers upgrade paths, pre-upgrade considerations for v26 and later, and the steps to upgrade from versions 25, 26, or 27 and install a version 28 update. It answers questions about how to get to v28 and what to check first.

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

Overview

This section is for administrators of on-premises Business Central who are moving to 2026 release wave 1 (version 28). It has four pages: an upgrade overview, a pre-upgrade considerations page, a step-by-step upgrade guide, and an update installation guide.

Start with the overview page, which explains the required upgrade paths, intermediate versions and the review of deprecated features. Then read the considerations page, which covers deprecated or redesigned functionality, schema changes, extension performance impact and deployment changes. After that, follow the upgrade page for unmodified applications from versions 25, 26 or 27. Use the install update page for platform-only or application updates within version 28.

Key points

  • The upgrade page covers unmodified applications moving from version 25, 26 or 27 to version 28.
  • Upgrade steps include application database conversion, extension publishing and installation, tenant synchronization, and data upgrade execution.
  • The upgrade page also covers permission sets migration and encryption key management.
  • The overview page says earlier versions may need specific upgrade paths with intermediate versions, and deprecated features should be reviewed first.
  • The considerations page covers v26-v29 and recommends moving to AL-based permissions.
  • It notes schema changes in the Subscription Billing extension from v25 to v26 and later, which involve force sync for schema migration.
  • It also notes that installed extensions can affect upgrade performance, and describes v23 deployment changes (port 7085, SPN delegation).
  • The install update page covers platform-only and application upgrades, database conversion, extension publishing and synchronization, for single-tenant and multitenant deployments.

Learn pages

Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.

What Learn documents here 4 Learn pages