{"title":"The lifecycle of apps and extensions for Business Central","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-app-life-cycle/","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-app-life-cycle, 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-app-life-cycle","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":"Learn how Marketplace apps behave during service and app updates, how administrators install updates, and how extension data is retained.","date":"2026-10-08","meta":{"topic":"overview"},"outline":[{"level":1,"title":"The lifecycle of apps and extensions for Business Central","slug":"the-lifecycle-of-apps-and-extensions-for-business-central","at":0,"chars":6556},{"level":2,"title":"Scenario 1: Business Central service update","slug":"scenario-1-business-central-service-update","at":772,"chars":399},{"level":3,"title":"Impact of service updates","slug":"impact-of-service-updates","at":960,"chars":211},{"level":2,"title":"Scenario 2: App update","slug":"scenario-2-app-update","at":1171,"chars":837},{"level":3,"title":"Impact of app updates","slug":"impact-of-app-updates","at":1496,"chars":512},{"level":2,"title":"Scenario 3: Reported bugs in your app","slug":"scenario-3-reported-bugs-in-your-app","at":2008,"chars":766},{"level":3,"title":"Impact of bugs","slug":"impact-of-bugs","at":2452,"chars":322},{"level":2,"title":"Scenario 4: Critical bug in your app","slug":"scenario-4-critical-bug-in-your-app","at":2774,"chars":439},{"level":2,"title":"Scenario 5: Microsoft feature breaks your app","slug":"scenario-5-microsoft-feature-breaks-your-app","at":3213,"chars":856},{"level":3,"title":"Impact of breaking changes","slug":"impact-of-breaking-changes","at":3611,"chars":458},{"level":2,"title":"Maintain and update your app","slug":"maintain-and-update-your-app","at":4069,"chars":2047},{"level":3,"title":"How Microsoft handles your app","slug":"how-microsoft-handles-your-app","at":4371,"chars":1745},{"level":2,"title":"Related information","slug":"related-information","at":6116,"chars":440}],"text":"# The lifecycle of apps and extensions for Business Central\nWhen you build an app or extension for Business Central and publish it to Marketplace, both the app and the online service receive updates. This article explains what happens after publication.\nWhen your app passes all of the validations and goes live on Marketplace, customers can install your extension and use it for their business. But you need to keep it compliant with the service and update it if something changes.\nThe following sections describe the different upgrade scenarios that play out as we update Business Central. Learn more about your responsibility for keeping your app updated and the resources that are available to you in Maintain Marketplace apps and per-tenant extensions<app-maintain>.\n## Scenario 1: Business Central service update\nYou don't need to make any bug fixes, feature additions, or other changes to your app. It continues to work without any action on your part.\n### Impact of service updates\nMonthly service updates don't require changes to your app or run the app's upgrade code. Business Central updates the tenant, and the app continues to work without visible changes.\n## Scenario 2: App update\nYou (our partner) add some features to your app and also some minor bug fixes. The app is submitted for validation. The app passes validation and is checked into the service. This is now the active app for any new tenants and also for existing tenants that have never had your app installed before.\n### Impact of app updates\nInternal and delegated administrators can update Marketplace apps from the Business Central administration center<../administration/tenant-admin-center-manage-apps>. Marketplace apps update to the latest compatible version during major environment updates. If Apps Update Cadence is set to With minor and major updates, they also update during minor environment updates. Regardless of cadence, a required compatible app update can be installed when necessary for an environment update.\n## Scenario 3: Reported bugs in your app\nYou (our partner) have various customers report some bugs that are impacting their usage of the app. The bugs aren't critical but they're important. The partner makes the fixes in the app and resubmits for validation. The app passes validation and gets checked into the service. This is now the active app for any new tenants and also for existing tenants that have never had your app installed before.\n### Impact of bugs\nThe service doesn't force an upgrade of this app to the latest version on all tenants. Some tenants might not use the functionality that contains the bug and can continue to use the current version. Work with impacted customers and their administrators to install the available update from Manage Apps.\n## Scenario 4: Critical bug in your app\nIf a bug breaks core functionality, causes data loss or corruption, or prevents customers from performing time-critical tasks, create a support ticket and provide a fixed app for validation through Partner Center. Work with support and the Marketplace validation team on the appropriate escalation. If the fixed app passes validation, it becomes available for environment administrators to install.\n## Scenario 5: Microsoft feature breaks your app\nMicrosoft might need to make a core Business Central change that isn't compatible with your app. Reasons can include security fixes, bugs in underlying code, and product changes. Microsoft tests installed apps against upcoming service versions and works with publishers to make compatible app versions available before affected environments update.\n### Impact of breaking changes\nIf an app update is required for an environment update, the service installs the compatible app version. If an incompatibility remains unresolved, the service can delay the environment update during the supported period. During an enforced-update period, the service might uninstall an extension that continues to block the update. The extension data is retained so that it can be recovered by installing a compatible version.\n## Maintain and update your app\nYou're responsible for your app. You own the process of updating the app and providing upgrade code if the schema changes between versions of the app. If a customer uninstalls your app and installs it again later, they get the latest available version from Marketplace.\n### How Microsoft handles your app\nWhen Microsoft prepares a service update, it tests installed apps for compatibility. The environment update can install required compatible app updates. If an app continues to block an enforced update, the service might uninstall it while retaining its data.\nWhen a tenant reinstalls an extension through the Extension Management page or Marketplace, the platform examines the retained uninstall record and data version. Reinstalling a newer version can run the upgrade path. Reinstalling the same version runs a reinstall path. If the app data wasn't retained, the platform treats the app as a new installation.\nBy default, uninstalling an extension retains its application data, which allows a later compatible version to reuse or upgrade that data. Data can be lost if the administrator chooses to delete application data or schema, or if a supported update operation performs a destructive schema or data migration. Before an extension is installed, it synchronizes with the tenant database. This automatic synchronization creates the database tables for the extension. After installation, extension-specific data is stored in these tables.\nWhen an extension is uninstalled with application data retained, its data remains available for a later reinstall or upgrade. If the administrator chooses to delete application data or clean the schema, the app's data or database artifacts are removed. While the extension is uninstalled, its event subscribers and code don't run. The app might therefore miss changes that occur during that period. Plan the uninstall and reinstall for a maintenance window.\nSee When apps or PTEs can't be updated by Microsoft<app-maintain#when-microsoft-cant-update-apps-or-ptes>.\n## Related information\ndevenv-how-publish-and-install-an-extension-v2\nRetaining table data after publishing<devenv-retaining-data-after-publishing>\ndevenv-upgrading-extensions\nAdd your app to Marketplace<../administration/appsource>\nChecklist for submitting your app<devenv-checklist-submission>\nUpgrading Marketplace apps in production<devenv-upgrade-appsource-app-in-prod>\nMaintain Marketplace apps and per-tenant extensions<app-maintain>"}