# Business Central: install the provided extension

Install an Optiply-provided Business Central `.app` package in the intended environment through the **admin center**. Confirm the package and compatible Business Central version with Optiply Support before installation. Installing the package is separate from connecting and synchronizing Optiply.

## Before you install the Business Central extension

You need admin-center access and the `.app` package supplied for your setup. Ask Support to confirm the package, version, target environment and any required dependencies. Have your Business Central administrator confirm the installation schedule and **Sync Mode**. Do not select a destructive schema option without their approval.

Microsoft recommends the admin center for per-tenant extension management. The older **Extension Management** upload route is deprecated and scheduled for removal in 2027 release wave 1. Use one management route consistently for an environment, because scheduled installations are not visible in the other route until installation succeeds.

## Steps to install the Business Central extension

1. Open the Business Central **admin center**.
2. Select **Environments**.
3. Select the confirmed target environment.
4. Select **Apps** to open **Manage Apps**.
5. Select **Install Extension**.
6. Browse to the provided `.app` package.
7. Choose the agreed **Deployment schedule**.
8. Choose the **Sync Mode** your administrator approved.
9. Review the terms before you accept and confirm installation.
10. Open **Operations** to check installation progress.
11. Return to **Manage Apps** after completion to check the installed extension.

For a new extension, choose immediate installation or the next update window. Microsoft does not support scheduling a new extension for a future environment update. See Microsoft's [admin-center app instructions](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/tenant-admin-center-manage-apps) for these scheduling choices.

## Fields in the Business Central extension installation

| Field or control | Meaning |
| --- | --- |
| Target environment | The production or sandbox environment that receives the package. |
| `.app` package | The extension file Support confirms for your setup. |
| **Deployment schedule** | When the validated package is installed. |
| **Sync Mode** | How extension schema changes are applied. Confirm this with your administrator. |
| **Operations** | Installation progress and operation details. |
| **Manage Apps** | Installed extensions and scheduled installations for the selected environment. |

## What you see when extension installation worked

The installation operation completes and the extension appears in **Manage Apps** for the selected environment. A scheduled operation is not an installed extension. Use the operation status rather than a fixed waiting period.

## Limits of installing the Business Central extension

The package must match your Business Central version. Package installation is separate from connector authorization, selected company, imported fields and synchronization checks.

If your administrator uses the older route, open **Extension Management** and select **Manage** → **Upload Extension**. Select the package, target version, language and approved **Schema Sync Mode**. Accept the disclaimer and select **Deploy**. Check **Deployment Status** and select **Refresh** for current details. After success, refresh the installed-extension list.

## If the Business Central extension did not install

Open the operation details and retain the non-sensitive error wording. Ask your administrator and Support to check package compatibility and dependencies. Do not uninstall an existing extension or repeatedly upload replacement packages to bypass an error.

## Related articles on Business Central connection preparation

- [Find your Business Central environment name](/article/microsoft-dynamics-365-setup-data-mapping).
- [Business Central data mapping](/article/integrations-data-mappings-public-microsoft-dynamics-365-business-central).
