{"title":"Embed App Overview","url":"https://jonas-paprotka.de/docs/dev-itpro/deployment/embed-app-overview/","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/deployment/embed-app-overview, 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/deployment/embed-app-overview","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":"Provides an overview of Embed App in Business Central","date":"2021-04-01","meta":{"topic":"overview"},"outline":[{"level":2,"title":"Components","slug":"components","at":689,"chars":5051},{"level":3,"title":"Partner Branding","slug":"partner-branding","at":1469,"chars":661},{"level":3,"title":"Exclusivity","slug":"exclusivity","at":2130,"chars":448},{"level":3,"title":"Code-customizations of the base application","slug":"code-customizations-of-the-base-application","at":2578,"chars":1332},{"level":3,"title":"Additional settings (metadata)","slug":"additional-settings-metadata","at":3910,"chars":1830},{"level":4,"title":"Platform version availability","slug":"platform-version-availability","at":4922,"chars":284},{"level":4,"title":"Deploying versions","slug":"deploying-versions","at":5206,"chars":534},{"level":2,"title":"Related information","slug":"related-information","at":5740,"chars":420}],"text":"Embed App is a term that defines an end-to-end solution meeting the specific needs of a vertical or micro-vertical industry.\nDynamics 365 Business Central plays a vital role in the Embed App, as Business Central is embedded as an integral part of the overall solution.\nSome examples of an Embed App include:\n A Dentist solution\n A Real Estate Agent solution\n A Food Processing solution\nAn Embed App refers to what is being provided to a given customer segment, unrelated to how the solution is being implemented or architected. An Embed App can be built using AL, in other words extension, code-customization, and a combination of extensions and code-customization.\n![Embed App overview.]\n## Components\nOn a high level, an Embed App is a package that consists of the following parts:\n Library extensions\n  This is the functionality of the Embed App that is implemented by the ISV partner in a form of extensions.\n Third party extensions\n  These are add-on extensions coming from other ISVs that contribute to and enhance the Embed App. The extensions are validated to be compatible by the Embed App owner.\n Extended metadata\n  This includes additional Embed App properties that are specific to this type of app and not otherwise available for other types of apps (see the list below).\n Base application and tenant template (optional)\nThe following capabilities are only available for the Embed App and not for other types of Business Central apps (Connect and Add-on).\n### Partner Branding\nThe Embed App will promote the partner's brand in several places:\n Web Client and Web Service URLs\n   Client: `https://[application name].bc.dynamics.com`\n   Web Services: `https://[application name].api.bc.dynamics.com`\n Name, image, and icon on the provisioning page of the Fixed Client Endpoint\n Splash screen of the client\n Title bar of the browser tab (for example, \"Fabrikam Apples\")\n A dedicated product tile, icon, and short marketing description in the Dynamics shell (https://www.microsoft365.com/<https://www.microsoft365.com/>)\n In-product messages (such as pop-up errors, warnings, notifications)\n![Tiles with Embed App apps.]\n### Exclusivity\nThe partner can control which third party apps can be installed for their Embed App.\n Safe listing of the 3rd party apps - no other apps will be possible to install, except the ones explicitly approved by the partner\n App install/uninstall controlled by the partner\n The partner can choose to allow a customer to install other extensions from the Marketplace, but this will be an explicit partner decision, not the default behavior\n### Code-customizations of the base application\nPartners can choose to bring their own code-customized base application as an Embed App for several reasons:\n Shortening time-to-market (\"lift and shift\" approach).\n  The partner's current solution is a significantly customized version of the Dynamics NAV application and it will require substantial time and effort to migrate it into extensions. A partner can lift their solution as-is (upgraded to a supported platform) to Business Central service and start offering it to their new and prospective customers. Then, they can gradually start moving their functionality into extensions to achieve the benefits that come with the extension model. The earliest version of the Business Central application you can bring to the service is version 16.\n Usage of .NET interoperability and custom assemblies.\n  Partners that use .NET interoperability in their current application to address multiple business scenarios. Although extensions today allow a number of these scenarios to be implemented in AL, they don't and cannot cover for all possible scenarios of .NET usage. Therefore, the partner can choose to import the required .NET add-ins into the Add-ins table of the base application, and these add-ins will automatically be deployed into the environment where they will be running.\n### Additional settings (metadata)\n An Embed App is the property of the partner, so the customers of the Embed App must be able to find the partner's own legal, privacy, contact, community and feedback links (not Microsoft links) when they work with the app:\n Safe listed domains for embedding Embed App pages into other web sites, including SharePoint (\"frame ancestors\")\n Target version of Dynamics 365 Business Central platform\n Target version of Dynamics 365 Business Central base application (if not included with the Embed App)\n Azure KeyVault account for storing application secrets, such as accounts for connecting to 1-3rd party services\n Base application + tenant template. This is an optional component of an Embed App. The partner can choose to include it or simply specify which version of the Dynamics 365 Business Central base application the Embed App should use as a base application.\nAt this stage, within the extensions and base application, the partner can work in their own Object ID range.\n#### Platform version availability\nMicrosoft is going to make new versions of the Business Central platform available to Embed App partners through the Lifecycle Services portal (LCS). The partner will then have to pick the platform they want to use for deployment of their solution.\n#### Deploying versions\nWhen a partner deploys a solution through the LCS portal, they can pick from the last three available versions of the platform (minor and major). Every newly released minor or major platform update will be added to the list and simultaneously one older version will be removed form that list.\nAny existing deployments, running on platform versions that are older than 3 updates, will enter a grace period of 30 days. And after that, if the deployment is not upgraded, it will be moved out of the standard SLA.\n## Related information\nmicrosoft-responsibilities\nembed-app-qualifications-onboarding\nManaging in Microsoft Lifecycle Services<embed-app-lifecycle-services>\nComponents and Capabilities<app-components>\nDeployment of Dynamics 365 Business Central<deployment>\nAdministration of Business Central Online<../administration/tenant-administration>\nAdministration of Business Central On-Premises<../administration/administration>"}