Deprecated Features in the Base App

This article describes the features that have been moved, removed, or replaced in the W1 version of Business Central.

Deprecated features won't be available in future versions of Business Central, and they are deprecated for different kinds of reasons. For example, a feature may no longer be relevant, or something better may have become available. If you use a feature that is listed, either the feature itself or an extension of it, you should look for or develop an alternative.

The next sections give a brief description of the deprecated features, state what happened to the feature, and explain why. The following table gives a few examples of what we mean by moved, removed, or replaced.

State Examples
Moved The capability has been moved from local functionality to W1 because it was no longer specific to one or more country versions. The capability was combined with other related functionality to eliminate redundancy.
Removed The capability will be removed in a coming release.
Replaced Something better has become available, and will be used instead.

This information will change with future releases, and might not include each deprecated feature.

Changes in 2023 release wave 1

The following features are marked as obsolete:pending in 2023 release wave 1.

French, Belgian, and Dutch features for reviewing G/L accounts

Moved, Removed, or Replaced? Why?
Replaced Businesses in all countries can benefit from the ability to review general ledger entries before posting them. In a future release, we'll deprecate the country-specific feature and replace it with one that's available in all country versions. After the feature is deprecated, you can use it to access previous reviews, but not to do new reviews. We'll archive your data according to local requirements. To learn about the replacement feature, go to Review Amounts in General Ledger Accounts.

User groups

Moved, Removed, or Replaced? Why?
Replaced User groups let administrators manage permissions for groups of users who have the same or similar roles in the business. For example, you might create a user group for your sales department, and one for your purchasers. To make it a bit easier for administrators to manage permissions, we're replacing user groups with security groups. The security groups in Business Central link to security groups in Azure Active Directory. The link let's administrators reuse the security group in other Dynamics 365 applications, without having to recreate the memberships in the group. In terms of managing permissions, security groups work in the same way as user groups. To learn more about the new security groups, go to Control Access Using Security Groups.

Changes in 2022 release wave 2

Permissions and Permission Set Objects

Moved, Removed, or Replaced? Why?
Replaced In the latest enhancements to composing permissions, the following legacy objects are marked as obsolete:pending and replaced with new ones:

* The Log Table Permissions code unit is replaced by the Log Table Data Permissions codeunit.

* The Permissions page is replaced by the Expanded Permissions page.

* The Tenant Permissions page is replaced by the Permission Set page.

For information about other objects and methods that are being obsoleted, refer to the obsolete reasons in permission management.

Microsoft SharePoint Connection Setup

Moved, Removed, or Replaced? Why?
Replaced The SharePoint connection setup feature used for OneDrive integration is obsolete and will be removed in 2023 release wave 2 (version 23). In its place, version 21 offers a new guided setup to configure OneDrive integration for system and application features. Learn more about the new setup at Managing OneDrive Integration with Business Central.

The deprecation means that the Microsoft SharePoint Connection Setup page (9551 Document Service Config) is marked as obsolete:pending. However, the platform APIs (in codeunit 9510 Document Service Management) and the document service table that make the legacy functionality possible aren't being deprecated. So any partner solutions that use the APIs directly are unaffected by this change.

Existing customers who are upgrading to version 21, and eventually version 22, can continue to use the legacy SharePoint/Onedrive integration. But we highly recommend that you transition them to the newer OneDrive integration because it's the path going forward. Switching to the newer OneDrive integration setup is a one-way operation, meaning you can't revert to the legacy setup after you've made the switch.

We aspire to resume work on SharePoint integration at a later date.

Changes in 2022 release wave 1

The following feature is marked as obsolete:pending in 2022 release wave 1.

XBRL reporting

Moved, Removed, or Replaced? Why?
Removed Over the years, XBRL has become more than just tagging your financial statement. It's seen improvements in the level of reporting detail, schemas are more flexible in their design, and ESAF has added customization capabilities. This development has meant that the XBRL implementations in the countries we support are diverse, and often complex. For example, taxonomies with hundreds of schema and linkbase files have become the norm. This complexity has made XBRL reporting a task that is better managed by either dedicated software or by service providers.

We recommend that you use these service providers. Alternatively, if you have the resources in-house, acquire a dedicated XBRL reporting tool. The XBRL org provides a list of tools and services. For more information, see Tools and Services.

Currently, we expect to fully remove support for XBRL in 2023 release wave 1.

Intercompany Setup page

Moved, Removed, or Replaced? Why?
Replaced We have consolidated settings for setting up intercompany capabilities on a single page, and have added a new feature for automatically accepting intercompany transactions in general journals. The current Intercompany Setup page (page 621) is replaced with a new Intercompany Setup page (page 653).

Bank Reconciliation Worksheet and Deposits in North American versions (US, CA, MX)

Moved, Removed, or Replaced? Why?
Replaced We're standardizing the features for reconciling bank accounts and making cash deposits, so that more country versions can benefit from them. For more information, see Standardizing the bank reconciliation process in North American versions. The current features will still allow you to view posted bank reconciliations done through the Bank Rec. Worksheet page, and posted deposits done through the Deposits features, but you can't use these features to create new entries. In April 2023, you must use the Bank Reconciliation page for bank reconciliations. The Bank Rec. Worksheet page won't be available.

Changes in 2021 release wave 2

Standard APIs, Beta version

The following feature will be Removed with Business Central 2021 release wave 2.

Moved, Removed, or Replaced? Why?
Removed Beta version of the standard APIs is removed in 2021 release wave 2. At this point, Beta APIs won't be available in new releases of Business Central. There are many improvements to v1.0 and v2.0 of the standard APIs. Improvements include more APIs, better performance and improved OData capabilities. It's recommended that integrations move to v2.0 of the standard APIs.

Client secret authentication in integrations between Microsoft-hosted Business Central online and Microsoft Dataverse

The following feature will be Removed with Business Central 2021 release wave 2.

Moved, Removed, or Replaced? Why?
Removed The ability to use client secret Service-to-Service authentication to connect Business Central with Dataverse will be removed for online tenants hosted by Microsoft in March 2022. To further strengthen security, we introduced the ability to use certificate-based authentication in client secret Service-to-Service authentication 2021 release wave 1 (version 18 and later). Existing users can easily switch to certificate-based authentication. For more information, see Upgrade Connections from Business Central Online to Use Certificate-Based Authentication. On-premises customers, and online tenants that are hosted by ISVs, can continue using client secret authentication for their connections to Dataverse.

Legacy Outlook add-in for synchronizing data

The legacy Outlook add-in for synchronizing data, such as to-dos, contacts, and tasks, between Business Central and Outlook is Removed in Business Central 2021 release wave 2.

Moved, Removed, or Replaced? Why?
Removed This add-in used Business Central web services based on outdated technology.


The feature is separate from and has no effect on the Business Central add-in for Outlook, which is described at Using Business Central as your Business Inbox in Outlook.

Deprecated Features in 2020 release wave 1

The following feature was marked as obsolete:pending in 2020 release wave 1.

Best Price Calculations

When you have recorded special prices and line discounts for sales and purchases, Business Central ensures that your profit on item trade is always optimal. Business Central calculates the best price on sales and purchase documents and on job and item journal lines.

Moved, Removed, or Replaced? Why?
Replaced The functionality is replaced with new calculations that you can extend to include other sources or calculation methods. The current capabilities will be available, and can be used in parallel with the new, until 2021 release wave 1. For more information, see Extending Best Price Calculations.

Deprecated Features in 2019 release wave 2

The following sections describe the features that were deprecated in 2019 release wave 2.

The Bank Data Conversion Service

You can use AMC's bank data conversion service to convert bank data from an XML file that you export from Business Central into a format that your bank can accept.

Moved, Removed, or Replaced? Why?
Moved The functionality has been moved to an extension. It now ships as the AMC Banking 365 Fundamentals extension, which can convert bank data to formats that are used by more than 600 banks worldwide. For more information, see Using the AMC Banking 365 Fundamentals extension.

Reports 204-207

You can generate external-facing documents, such as sales invoices and order confirmations, that you send to customers as PDF files.

The reports in the 204-207 range are replaced by the following updated reports in the 1304 to 1307 range:

  • 204, Sales-Quote -> 1304, Standard Sales-Quote
  • 205, Order-Confirmation -> 1305, Standard Sales-Order Conf.
  • 206, Sales-Invoice -> 1306, Standard Sales-Invoice
  • 207, Credit-Memo -> 1307, Standard Sales-Credit Memo


The No. of Copies field is removed from the new reports because of performance reasons and because selection of the quantity to print works differently on modern printers. To print a report more than once, users can list the same report multiple times on the Report Selection page for the document type in question.

Moved, Removed, or Replaced? Why?
Replaced The reports in the 204-207 range are replaced by the reports in the 1304 to 1307 range. To avoid duplicated features, the reports in the 204-207 range will be removed.

User Personalizations and Profile Configurations

You can personalize pages and configure profiles by adding or removing fields, and Business Central will save your changes.

Moved, Removed, or Replaced? Why?
Replaced The shift to AL made the legacy features for personalization and configuring profiles outdated. Therefore, we've introduced new tooling. In this release, existing personalizations and configurations are discarded, and you must use the new tools to recreate them. Your new changes will be kept in future releases.

Objects that have been marked as obsolete

Part of deprecating features is marking the objects that comprise them as "obsolete." Before we deprecate an object, we tag it as "obsolete:pending" to alert our partners of it's deprecation. The object will have the tag for one year before we remove it from Business Central.

Breaking Changes

When we move, remove, or replace an object, breaking changes can occur in other apps or extensions that use the object. To help our partners identify and resolve breaking changes, we have created a Breaking Changes document. The document lists known issues and suggestions for what to do about them.

Features that are available only in the online version

Some features are available only under specific circumstances, or not at all intended for use in on-premises versions of Business Central. For a list and descriptions of those features, see Features not implemented in on-premises deployments.

See Also

Deprecated Features in the Platform - Clients, Server, and Database
Deprecated Features in the Austrian Version
Deprecated Features in the Belgian Version
Deprecated Features in the Canadian Version
Deprecated Features in the Czech Version
Deprecated Features in the Dutch Version
Deprecated Features in the Finnish Version
Deprecated Features in the German Version
Deprecated Features in the Icelandic Version
Deprecated Features in the Italian Version
Deprecated Features in the Mexican Version
Deprecated Features in the Norwegian Version
Deprecated Features in the Russian Version
Deprecated Features in the Swedish Version
Deprecated Features in the Swiss Version
Deprecated Features in the UK Version
Deprecated Features in the United States Version
Deprecated Fields, and Fields Marked as Obsolete in Local Functionality Deprecated Tables
AlAppExtensions repository
Best Practices for Deprecation of Code in the Base App
Microsoft Timeline for Deprecating Code in Business Central