{"title":"Retain permissions during cloud migration","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/migration-retain-permissions/","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/administration/migration-retain-permissions, 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/administration/migration-retain-permissions","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 keep the permissions assigned to existing online users so they can continue to work as usual during cloud migration.","date":"2026-11-17","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Retain permissions during cloud migration","slug":"retain-permissions-during-cloud-migration","at":0,"chars":2448},{"level":2,"title":"Option 1: Use the Cloud Migration Management page in the client","slug":"option-1-use-the-cloud-migration-management-page-in-the-client","at":841,"chars":850},{"level":2,"title":"Option 2: Use a custom extension","slug":"option-2-use-a-custom-extension","at":1691,"chars":419},{"level":2,"title":"Next steps","slug":"next-steps","at":2110,"chars":57},{"level":2,"title":"Related information","slug":"related-information","at":2167,"chars":281}],"text":"# Retain permissions during cloud migration\nBy default, once you set up cloud migration, Business Central removes system-scope permission set assignments from existing online users, except users with the SUPER permission set, and assigns the INTELLIGENT CLOUD permission set. The LOCAL permission set is retained. This change is done to prevent users, other than SUPER users, from making data modifications.\nThe Business Central 14 migration retains user permissions automatically.\nHowever, you might want some users to keep their original permissions, for various reasons. For example, you want them to continue working on your data while it's being replicated, or you want to use service-to-service apps that require specific permissions.\nIf you want users to keep their permissions during cloud migration, you have the following options:\n## Option 1: Use the Cloud Migration Management page in the client\nBefore setting up cloud migration, use an account with the SUPER permission set to change this setting. Changing the setting doesn't restore permissions that were already removed.\n1. Sign in to Business Central online<https://businesscentral.dynamics.com/>.\n1. Search for and open the Cloud Migration Management page.\n1. In the action bar, select Actions > Enable/Disable Removing Permissions from Users. If Actions isn't visible, select More options first.\n  If the message Setting for Keeping user permissions was set to: Yes. appears, then permission sets remain. Select OK.\n  If the message Setting for Keeping user permissions was set to: No. appears, then the default permission-reset behavior applies when migration is set up. Select OK and repeat this step to change to Yes.\n## Option 2: Use a custom extension\nBefore setting up cloud migration, create and install a per-tenant extension that includes the following code:\n```al\n[EventSubscriber(ObjectType::Codeunit, Codeunit::\"Hybrid Deployment\", 'OnBeforeResetUsersToIntelligentCloudPermissions', '', false, false)]\nlocal procedure HandleBeforeResetUsersToIntelligentCloudPermissions(var Handled: Boolean)\nbegin\n    Handled := true;\nend;\n```\n## Next steps\nRun data migration setup<migration-setup>.\n## Related information\nDynamics GP migration to Business Central online: End-to-end overview<migrate-gp-overview>\nCompare work in Dynamics GP to Business Central<migrate-dynamics-gp-videos>\nFAQ about migrating to Business Central online from on-premises solutions<faq-migrate-data>"}