{"title":"Moving between extension scopes","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-extension-moving-scope/","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-extension-moving-scope, 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-extension-moving-scope","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":"Describes how an extension in one scope can be moved into another scope in Business Central.","date":"2025-05-02","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Moving between extension scopes","slug":"moving-between-extension-scopes","at":0,"chars":8410},{"level":2,"title":"Moving a PTE to Marketplace","slug":"moving-a-pte-to-marketplace","at":238,"chars":2123},{"level":3,"title":"Identity requirements for moving a PTE to Marketplace","slug":"identity-requirements-for-moving-a-pte-to-marketplace","at":412,"chars":694},{"level":3,"title":"Other requirements for moving a PTE to Marketplace","slug":"other-requirements-for-moving-a-pte-to-marketplace","at":1106,"chars":711},{"level":3,"title":"Other information for moving a PTE to Marketplace","slug":"other-information-for-moving-a-pte-to-marketplace","at":1817,"chars":544},{"level":2,"title":"Moving a DEV extension to Marketplace","slug":"moving-a-dev-extension-to-marketplace","at":2361,"chars":1904},{"level":3,"title":"Identity requirements for moving a DEV extension to Marketplace","slug":"identity-requirements-for-moving-a-dev-extension-to-marketplace","at":2556,"chars":943},{"level":3,"title":"Other requirements for moving a DEV extension to Marketplace","slug":"other-requirements-for-moving-a-dev-extension-to-marketplace","at":3499,"chars":766},{"level":2,"title":"Publishing a Marketplace app as a DEV extension","slug":"publishing-a-marketplace-app-as-a-dev-extension","at":4265,"chars":1403},{"level":3,"title":"Identity requirements for publishing a Marketplace app as a DEV extension","slug":"identity-requirements-for-publishing-a-marketplace-app-as-a-dev-extension","at":4839,"chars":442},{"level":3,"title":"Other requirements for publishing a Marketplace app as a DEV extension","slug":"other-requirements-for-publishing-a-marketplace-app-as-a-dev-extension","at":5281,"chars":387},{"level":2,"title":"Publishing a PTE as a DEV extension","slug":"publishing-a-pte-as-a-dev-extension","at":5668,"chars":324},{"level":3,"title":"Identity requirements for publishing a PTE as a DEV extension","slug":"identity-requirements-for-publishing-a-pte-as-a-dev-extension","at":5802,"chars":101},{"level":3,"title":"Other requirements for publishing a PTE as a DEV extension","slug":"other-requirements-for-publishing-a-pte-as-a-dev-extension","at":5903,"chars":89},{"level":2,"title":"Moving a DEV extension to a PTE","slug":"moving-a-dev-extension-to-a-pte","at":5992,"chars":394},{"level":3,"title":"Identity requirements for moving a DEV extension to a PTE","slug":"identity-requirements-for-moving-a-dev-extension-to-a-pte","at":6085,"chars":97},{"level":3,"title":"Other requirements for moving a DEV extension to a PTE","slug":"other-requirements-for-moving-a-dev-extension-to-a-pte","at":6182,"chars":204},{"level":2,"title":"Moving a Marketplace app to a PTE","slug":"moving-a-marketplace-app-to-a-pte","at":6386,"chars":1886},{"level":3,"title":"Identity requirements for moving a Marketplace app to a PTE","slug":"identity-requirements-for-moving-a-marketplace-app-to-a-pte","at":6492,"chars":536},{"level":3,"title":"Other requirements for moving a Marketplace app to a PTE","slug":"other-requirements-for-moving-a-marketplace-app-to-a-pte","at":7028,"chars":498},{"level":3,"title":"Other information for moving a Marketplace app to a PTE","slug":"other-information-for-moving-a-marketplace-app-to-a-pte","at":7526,"chars":746},{"level":2,"title":"Related information","slug":"related-information","at":8272,"chars":138}],"text":"# Moving between extension scopes\nThis article describes the different options you have for moving an app from one scope to another.\nFor a definition of the different extension types and their scope, see devenv-extension-types-and-scope.\n## Moving a PTE to Marketplace\nScenario: You deployed your extension for selected customers as a PTE and now want to cover more markets by deploying it as a Marketplace app.\n### Identity requirements for moving a PTE to Marketplace\n It isn't possible to deploy a Marketplace app and a PTE with the same id. You must then change the id of the extension before uploading it to Marketplace. This means that the data won't be available anymore for environments that had the PTE installed and are now using the Marketplace app. Dependent extensions also must be updated to use the new app ID in their app.json file.\n Due to some current limitations in our service, it isn't possible to have a Marketplace app and a PTE extension with the same name, publisher, and version. You must then change the name, publisher, or version of the app before uploading it to Marketplace.\n### Other requirements for moving a PTE to Marketplace\n Marketplace apps and PTEs are using different ID ranges. You must then change the ID of all the objects in your extension. See devenv-object-ranges.\n Marketplace apps are required to use affixes for their object names, while PTEs don't have any affix usage requirements. You might then have to rename all the objects in your extension to use affixes. See Benefits and guidelines for using a prefix or suffix<../compliance/apptest-prefix-suffix>.\n You can find the full list of requirements for Marketplace apps here:\n   Technical Validation Checklist<devenv-checklist-submission>\n   Marketing Validation Checklist<readiness/readiness-checklist-marketing>\n### Other information for moving a PTE to Marketplace\n If you want to move the data by having the two apps (PTE and Marketplace app) installed side-by-side, then you must ensure that the two apps can be installed side-by-side. For this, they must not share any object names nor IDs. You can then define another PTE depending on both apps that would take care of moving the data.\n Update all dependent extensions to use the new app ID in their app.json file and to reference the objects defined in the extension by their new name and object ID.\n## Moving a DEV extension to Marketplace\nScenario: You're done developing a new offer or a new version of an existing offer and are now ready to make it available for all your customers in SaaS.\n### Identity requirements for moving a DEV extension to Marketplace\n It's not possible to deploy a Marketplace app and a PTE with the same id. You must then change the id of the extension before uploading it to Marketplace. This means that the data won't be available anymore for environments that had the PTE installed and are now using the Marketplace app. Dependent extensions need to be updated to use the new app ID in their app.json file.\n Due to some current limitations in our service, it isn't possible to have a Marketplace app and a PTE extension with the same name, publisher, and version. You must then change the name, publisher, or version of the app before uploading it to Marketplace.\n> NOTE\n> Alternatively, you can also uninstall and unpublish the DEV extension with this app id from your sandbox environment. Make sure to select the option to delete the extension data and extension schema when uninstalling the extension.\n### Other requirements for moving a DEV extension to Marketplace\n Marketplace apps must use a specific ID range, while DEV extensions don't have any ID range limitation. You might need to change the ID of all the objects in your extension. See devenv-object-ranges.\n Marketplace apps must use affixes for their object names, while DEV extensions don't have any affix usage requirements. You might need to rename all the objects in your extension to use affixes. See Benefits and guidelines for using a prefix or suffix<../compliance/apptest-prefix-suffix>.\n You can find the full list of requirements for Marketplace apps here:\n   Technical Validation Checklist<devenv-checklist-submission>\n   Marketing Validation Checklist<readiness/readiness-checklist-marketing>\n## Publishing a Marketplace app as a DEV extension\nScenario: Showing a preview of an app to a customer or developing the next version of the app.\nPublishing a Marketplace app to a sandbox environment as a DEV extension is a common scenario when you want to show a preview of your app to a customer or during active development.\n> NOTE\n> From Business Central 2023 release wave 2, it's possible to install a preview of Marketplace apps on customer environments without publishing them as DEV extensions. See Technical Validation FAQ<devenv-checklist-submission-app-preview>.\n### Identity requirements for publishing a Marketplace app as a DEV extension\n DEV extensions should have a different app id because there might be other global apps published to your service and they collide. If you don't change the app id, the app that you published from Visual Studio Code to a developer sandbox is automatically unpublished from your environment if another user tries to install the Marketplace app in their environment.\n### Other requirements for publishing a Marketplace app as a DEV extension\n If you don't change the app id of the Marketplace app in your DEV extension, publishing the DEV extension is prevented when another Marketplace app depends on that particular Marketplace app. To achieve such functionality, publish the whole chain of dependencies as DEV extensions with different app id values.\n## Publishing a PTE as a DEV extension\nScenario: Showing a preview of an app to a customer or developing the next version of the app.\n### Identity requirements for publishing a PTE as a DEV extension\nNo specific identity requirements.\n### Other requirements for publishing a PTE as a DEV extension\nNo specific requirements.\n## Moving a DEV extension to a PTE\nScenario: Deploying your app to a production environment.\n### Identity requirements for moving a DEV extension to a PTE\nNo specific identity requirements.\n### Other requirements for moving a DEV extension to a PTE\nYou can find the full list of requirements for PTE in the documentation for the PerTenantExtensionCop Analyzer<analyzers/pertenantextensioncop>.\n## Moving a Marketplace app to a PTE\nScenario: Reducing the availability of your app to select customers.\n### Identity requirements for moving a Marketplace app to a PTE\n You can't deploy a Marketplace app and a PTE with the same id. You must change the id of the extension before deploying it as a PTE. This change means that the data isn't available anymore for environments that had the Marketplace app installed and are now using the PTE. You need to update dependent extensions to use the new app ID in their app.json file.\n If you wish to deprecate the offer in Marketplace, see Discontinuing a Marketplace app<devenv-app-discontinue>.\n### Other requirements for moving a Marketplace app to a PTE\n Marketplace apps and PTEs use different ID ranges. You must change the ID of all the objects in your extension. See devenv-object-ranges.\n To avoid potential name conflicts if the Marketplace app and the PTE are installed side-by-side, change the name of all the objects in your extension.\n You can find the full list of requirements for PTE in the documentation for the PerTenantExtensionCop Analyzer<analyzers/pertenantextensioncop>.\n### Other information for moving a Marketplace app to a PTE\n Even if you stop distributing the offer in Partner Center, the app still exists in Business Central and the app ID remains reserved for it. You can't attribute the app ID to the PTE.\n If you want to move the data by having the two apps (PTE and Marketplace app) installed side-by-side, then you must ensure that the two apps can be installed side-by-side. For this, they must not share any object names nor IDs. You can then define another PTE depending on both apps that would take care of moving the data.\n All dependent extensions have to be updated to use the new app id in their app.json file and to reference the objects defined in the extension by their new name and object ID.\n## Related information\nDeveloping extensions<devenv-dev-overview>\nGet started with AL<devenv-get-started>\ndevenv-extension-types-and-scope"}