{"title":"Migration JSON file","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-migration-json-file/","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-migration-json-file, 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-migration-json-file","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":"Description of the JSON file for data migration for AL in Business Central.","date":"2025-05-02","meta":{"topic":"concept-article"},"outline":[{"level":2,"title":"Create the migration.json file","slug":"create-the-migrationjson-file","at":743,"chars":675},{"level":2,"title":"Related information","slug":"related-information","at":1418,"chars":116}],"text":"Data migration allows you to move table and field data between extensions. The migration.json file provides a pointer to the ID of an app that one or more tables are moved to. This file allows you to move table and field data from, for example, a code-customization on the base application to an extension of the base application. The migration.json file can be added into the app project of an extension that a table is moved from to specify the ID of the app that the table is moved to. It can, for example, be placed at the root of the AL project. The migration.json file must be created manually by following the steps and syntax as described below.\nIn the extension app.json file, ensure that `\"target\": \"OnPrem\"`. See devenv-json-files.\n## Create the migration.json file\n1) In the root folder of the app project that will migrate data to a different app project, choose New File.\n2) Name the file migration.json.\n3) Edit the file by adding one or more IDs inside the `\"apprules\":[]` section, such as:\n```json\n{\n    \"apprules\": [\n        {\n            \"id\": \"12345678-abcd-abcd-abcd-1234567890ab\"\n        }\n    ]\n}\n```\n4) Save the migration.json file in the project.\nYou now have the migration file in place for the data migration from one app project to another. The migration file is used for performing the data migration steps. See Migrating tables and fields between extensions<devenv-migrate-table-fields>.\n## Related information\ndevenv-json-files\nMigrating tables and fields between extensions<devenv-migrate-table-fields>"}