{"title":"Publishing and installing an extension","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-how-publish-and-install-an-extension-v2/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-how-publish-and-install-an-extension-v2, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-how-publish-and-install-an-extension-v2","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Description of the process of publishing and installing an extension.","date":"2025-02-05","meta":{"topic":"how-to"},"outline":[{"level":2,"title":"Publish and synchronize an extension","slug":"publish-and-synchronize-an-extension","at":605,"chars":2174},{"level":2,"title":"Install an extension","slug":"install-an-extension","at":2779,"chars":1606},{"level":3,"title":"Install an extension by using Business Central Administration Shell","slug":"install-an-extension-by-using-business-central-administration-shell","at":3381,"chars":525},{"level":3,"title":"Install an extension by using the client","slug":"install-an-extension-by-using-the-client","at":3906,"chars":479},{"level":2,"title":"Related information","slug":"related-information","at":4385,"chars":204}],"text":"To make your extension available to tenant users requires three basic tasks: publish the extension package to the Dynamics 365 Business Central server instance, synchronize the extension with the tenant database, and install the extension on the tenant.\n> NOTE\n> This article describes how to publish and install the first version of an extension. If you want to publish an install newer version of an extension, see devenv-upgrading-extensions.\n> NOTE\n> To be able to publish apps for Business Central on-premises, you must have a developer license. See Get started building apps<readiness/get-started>.\n## Publish and synchronize an extension\nPublishing an extension to a Dynamics 365 Business Central server instance adds the extension to the application database that is mounted on the server instance, making it available for installation on tenants of the server instance. Publishing updates internal tables, compiles the components of the extension behind-the-scenes, and builds the necessary metadata objects that are used at runtime.\nSynchronizing an extension updates the database schema of the tenant database with the database schema that is defined by the extension objects. If a table or table extension is included in the extension, the respective full or companion table is created in the tenant database.\n1. Start the Business Central Administration Shell.\n1. To publish the extension, run the Publish-NAVApp cmdlet<https://learn.microsoft.com/powershell/module/microsoft.dynamics.nav.apps.management/publish-navapp>.\n The cmdlet takes as parameters the Dynamics 365 Business Central service instance that you want to install to and the .app package file that contains the extension. The following example publishes the extension MyExtension.app to the YourDynamicsNAVServer instance.\n ```powershell\n Publish-NAVApp -ServerInstance YourDynamicsNAVServer -Path \".\\MyExtension.app\"\n ```\n> NOTE\n> If you are publishing a version 16.0 Microsoft extension, you'll have to include the `-SkipVerification` parameter. Otherwise, you will get the error \"Publish-NAVApp : You cannot publish an extension that has not been code signed.\". This issue is fixed in later versions.\n1. To synchronize the schema of a tenant database to the extension, run the Sync-NavApp cmdlet<https://learn.microsoft.com/powershell/module/Microsoft.Dynamics.Nav.Apps.Management/Sync-NAVApp>.\n The following example synchronizes the extension MyExtension with version number 1.0.0.0:\n ```powershell\n Sync-NavApp -ServerInstance YourDynamicsNAVServer -Name ExtensionName -Version 1.0.0.0 -Tenant TenantID\n ```\n Replace TenantID with the tenant ID of the database. If you don't have a multitenant server instance, use default or omit this parameter.\nThe extension can now be installed on tenants.\n## Install an extension\nAfter you publish and synchronize an extension, you can install it on tenants. The extension is then available to users in the client. Installing an extension can be done from the Dynamics 365 client or Business Central Administration Shell.\n> NOTE\n> Installing an extension will run any installation code that is built-in to the extension. Installation code could, for example, perform operations like populating empty records with data, service callbacks and telemetry, version checks, and messages to users. See Writing Extension Install Code<devenv-extension-install-code>.\n### Install an extension by using Business Central Administration Shell\n1. Start the Business Central Administration Shell.\n1. To install the extension on one or more tenants, use the `Install-NAVApp` cmdlet.\n The following example installs the extension My Extension for Tenant1 and Tenant3. In single-tenant deployments, you either specify default as the tenant ID, or you omit the `–Tenant` parameter.\n ```powershell\n Install-NAVApp -ServerInstance YourDynamicsNAVServer -Name \"My Extension\" –Tenant Tenant1, Tenant3\n ```\n### Install an extension by using the client\n1. In Dynamics 365 Business Central, use search to open the Extension Management page.\n In the Extension Management window, you can view the extensions that are published to your server. For each extension, you can see the current installation status.\n1. Select an extension to see additional information and to install the extension.\n1. Review and accept the license agreement.\n1. Select the Install button to install the extension.\n## Related information\ndevenv-unpublish-and-uninstall-extension-v2\nDeveloping Extensions<devenv-dev-overview>\nAnalyzing Extension Lifecycle Telemetry<../administration/telemetry-extension-lifecycle-trace>"}