Install and Uninstall Extensions in Business Central

You can change Business Central by installing extensions that, for example, add functionality, changes behavior, or gives you access to new online services. For more information, see Customizing Business Central Using Extensions.

[!NOTE] To install or uninstall extensions from AppSource or add per-tenant extensions, you must have the right permissions. You must either be a member of the EXTEND. MGT. - ADMIN user group or you must have the EXTEND. MGT. - ADMIN permission set. If you are an administrator, you can assign user groups and permissions to other users in your company.

To use the functionality that is provided by an extension, such as opening pages, running reports, selecting actions, and so on, you must be assigned the permission sets that are installed as part of the extension.

[!NOTE]
The EXTEND. MGT. - ADMIN permission set was introduced in Business Central 2021 release wave 1 as a replacement for the D365 EXTENSION MGT permission set in earlier versions.

Install an Extension

You manage extensions on the Extension Management page. You can access this page from Home. Alternatively, choose the Search for Page or Report icon Lightbulb that opens the Tell Me feature. in the top right corner, enter Extension, and then choose the related link.

You can get new extensions from the marketplace at AppSource.microsoft.com. Here, you can see all available extensions for Business Central.

[!NOTE]
Sign in to AppSource.microsoft.com using the email account that you use for Business Central. Use the same email account for other services and products for a smooth experience.

You can also get to the marketplace from inside Business Central extensions that are currently available in AppSource. If you choose the More apps link, you are taken to AppSource.microsoft.com.

If you choose an extension, you can read about what the extension does, and you can access Help for the extension to learn more. When you choose to get an extension, you must agree to the terms of use. If you get the extension from the AppSource website, you will be signed in to Business Central to complete the installation.

When you install an extension, you might have to set it up, such as specifying an account for use with the PayPal Payments Standard for Business Central extension. Other extensions simply add fields to an existing page, or they add a new page, for example.

If you uninstall an extension, and you then change your mind, you can install it again. When you uninstall an extension that you have been using, the data is preserved so that if you install the extension again, your data is still available. There are some extensions that are required. You are prevented from uninstalling these from the Extension Management page. If you try, an error message appears.

Some extensions are provided by Microsoft, and other extensions are provided by other companies. All extensions are tested before they are made available to you, but we recommend that you access the links that are provided with each extension to learn more about the extension before you choose to install it.

Microsoft provides the following extensions:

Upload a Per-Tenant Extension (PTE)

You upload a PTE by using the Extension Management page. On the Extension Management page, go to Manage, then choose Upload Extension. On the Upload and Deploy Extension page, specify the .app file to upload. To proceed, choose the Accept button, and then the Deploy button, this will start the process of deploying the PTE.

If the PTE contains breaking schema changes, it is possible to force an upload of it. To do that, in the Schema Sync Mode choose the Force option. You will get a confirmation dialog to accept before proceeding.

Uninstall an Extension

You uninstall an extension by using the Extension Management page. If you uninstall an extension, and you then change your mind, you can install the extension again. When you uninstall an extension that you have been using, data is by default preserved so that if you install the extension again. You can instead choose to delete the data with the extension. This is controlled by the Delete Extension Data checkbox. By default, this checkbox is not enabled.

[!IMPORTANT]
If you enable the Delete Extension Data checkbox, you will get a confirmation dialog and you must choose OK. With the Delete Extension Data checkbox enabled, you can now uninstall the extension, and you will be asked to reconfirm that you want to uninstall the extension and delete the data. The action cannot be undone. Some extensions are required. You are prevented from uninstalling these from the Extension Management page. If you try, an error message appears.

See Also

Customize Business Central
Business Central Extensions by Other Providers
Set Up the Envestnet Yodlee Bank Feeds Service
Enable Customer Payment Through PayPal
Migrating Business Data from Other Finance Systems
Setting Up the GetAddress.io UK Postal Code extension
Business Central Extensions by Other Providers
Getting Ready for Doing Business

Start a free trial!

--- author: edupont04

ms.topic: include ms.date: 12/20/2021 ms.author: edupont

Business Central on Microsoft Learn