{"title":"Discontinue a Marketplace app","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-app-discontinue/","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-discontinue, 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-discontinue","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 to stop distributing a Marketplace app, notify existing customers, preserve support during the wind-down, and manage installations.","date":"2026-10-09","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Discontinue a Marketplace app","slug":"discontinue-a-marketplace-app","at":0,"chars":3610},{"level":2,"title":"Update the Marketplace listing","slug":"update-the-marketplace-listing","at":245,"chars":932},{"level":2,"title":"Notify existing customers (T+1 to T+60)","slug":"notify-existing-customers-t1-to-t60","at":1177,"chars":297},{"level":2,"title":"Stop distributing the Marketplace offer (T+150)","slug":"stop-distributing-the-marketplace-offer-t150","at":1474,"chars":609},{"level":2,"title":"Frequently asked questions about discontinuing an app","slug":"frequently-asked-questions-about-discontinuing-an-app","at":2083,"chars":1274},{"level":3,"title":"Do I have to uninstall the app for every tenant?","slug":"do-i-have-to-uninstall-the-app-for-every-tenant","at":2140,"chars":164},{"level":3,"title":"How should customers be notified?","slug":"how-should-customers-be-notified","at":2304,"chars":369},{"level":3,"title":"Does the app get automatically uninstalled from customer environments?","slug":"does-the-app-get-automatically-uninstalled-from-customer-environments","at":2673,"chars":506},{"level":3,"title":"Is the app removed from Business Central?","slug":"is-the-app-removed-from-business-central","at":3179,"chars":178},{"level":2,"title":"Related information","slug":"related-information","at":3357,"chars":253}],"text":"# Discontinue a Marketplace app\nThe following sections describe the process that Marketplace partners can follow to remove an app from the Marketplace.\nIn this timeline, T is the date you deprecate the app, and the offsets are measured in days.\n## Update the Marketplace listing\nUpdate the Marketplace listing to inform potential customers that the app shouldn't be installed and that it will not be maintained in the future. The Marketplace listing should still remain available to allow you to deploy bug fixes for your existing customers, but also to allow your existing customers to reinstall the app if they have uninstalled it by accident as their business might depend on it.\n> NOTE\n> Because new customers can still install the offer, switch the listing type to Contact Me to remove the storefront's self-service acquisition path and route prospects to you. Contact Me isn't an access-control or licensing mechanism. Customers who know the app ID can still install the app through supported APIs or a direct installation URL. Add entitlement logic to the app if you must restrict its use. See readiness/readiness-checklist-e-industries-categories-apptype#listing-type.\n## Notify existing customers (T+1 to T+60)\nNotify existing customers through the channels that you consider most appropriate. Explain that the app is deprecated and that you plan to stop its distribution. If possible, recommend alternatives that customers can use for the same business scenarios.\n## Stop distributing the Marketplace offer (T+150)\nWhen the wind-down period ends, select Stop distribution on the offer overview in Partner Center. This action prevents new acquisition. Existing installations can continue to run, but customers can't redownload or redeploy the stopped offer. Maintain the app until you stop its distribution. See Update an existing offer in the commercial marketplace<https://learn.microsoft.com/azure/marketplace/update-existing-offer#stop-distribution-of-an-offer-or-plan>.\nAfter distribution stops, the offer remains visible in Partner Center with a Not available status.\n## Frequently asked questions about discontinuing an app\n### Do I have to uninstall the app for every tenant?\nNo. It's the responsibility of the partner maintaining the environment to uninstall the app when they see fit.\n### How should customers be notified?\nPlan to notify customers directly when you deprecate an offer. If the app later blocks an environment update, the partner who maintains the environment receives information about the blocking app and can uninstall it or contact you. See Maintain Marketplace apps and per-tenant extensions in Business Central online<app-maintain>.\n### Does the app get automatically uninstalled from customer environments?\nStopping distribution doesn't automatically uninstall the app from customer environments. However, during an enforced-update period, the service might automatically uninstall an extension that continues to block the environment update. The extension's data is retained so that it can be recovered by installing a compatible version. See Maintain Marketplace apps and per-tenant extensions in Business Central online<app-maintain>.\n### Is the app removed from Business Central?\nEven after you remove your offer from Marketplace, the app remains stored in Business Central because customers might still use it.\n## Related information\nThe lifecycle of apps and extensions for Business Central<devenv-app-life-cycle>\nMaintain Marketplace apps and per-tenant extensions in Business Central online<app-maintain>\nUnderstand app identity for AL apps<devenv-app-identity>"}