Convert an existing Unmanaged solution in a Dynamics 365 CRM production environment into a Managed solution without affecting existing Data
Key Principles
- Solutions
only contain metadata, not data
- Managed or unmanaged solutions only deal with customizations
(entities, forms, views, fields, workflows, plugins, etc.).
- Data in your tables (accounts, contacts, orders,
etc.) is not affected by exporting/importing a solution as long as
you don’t delete entities.
- You
cannot directly “convert” an unmanaged solution into managed in the same
environment.
- D365 doesn’t allow turning an existing unmanaged
solution into managed in-place.
- Instead,
the approach is: export the unmanaged solution as managed and import
it where needed (even back to the same org if required).
Step-by-Step Approach
Option 1: Export Unmanaged Solution as Managed
- Go to Settings → Solutions in Production (or
Dev environment if that’s safer first).
- Open your unmanaged solution.
- Click Export.
- Choose Managed instead of Unmanaged.
- Follow the wizard and export the .zip file.
- This
creates a managed version of your solution.
- ⚠️
Important: Any unmanaged customizations outside this solution will
remain unmanaged. The managed solution only contains components included
in the exported solution.
Option 2: Import Managed Solution Without Affecting Data
- Navigate to the environment where you want to
import.
- Go to Settings → Solutions → Import.
- Select the exported managed solution zip
file.
- D365 will check dependencies.
- Finish
the import.
✅ Your existing production
data will remain intact, because solutions do not contain data
unless you explicitly include a data migration step (like using
Configuration Migration Tool or data entities).
Option 3: Safe Strategy for Production
- Best
practice is not to export from Production directly. Instead:
- Maintain all unmanaged customizations in a Dev
or Sandbox environment.
- Export managed solution from Sandbox.
- Import
into Production.
- This
avoids potential errors or locking issues in Production.
Important Notes
- Managed solutions are read-only in target
environment: you cannot edit components directly.
- If there are unmanaged changes already in
Production outside the solution, exporting as managed won’t capture
them.
- Do
not delete unmanaged components in Production when importing a managed
solution — it can cause data loss for entities if the managed solution
enforces deletion of components.
💡 Tip:
If your goal is to “lock” production customizations into a managed package
while keeping data safe:
- Always export from a sandbox.
- Include all entities, fields, forms, views,
processes.
- Mark the solution managed during export.
- Import
to Production — all live data stays untouched.
✅ Key Points
- Data
Safety
- Importing
a managed solution does not delete or modify existing records in
entities unless you delete the entity itself (which we avoid).
- Solution
Read-Only
- Once imported, the managed solution components
cannot be edited in Production directly.
- Only
unmanaged components outside the solution can be modified.
- Dependencies
- If
your solution uses other entities or solutions, Dynamics 365 will prompt for dependencies
before import.
- Best
Practice
- Always export as managed from Dev/Sandbox,
never directly from Production unless necessary.
- Keep
a backup of both unmanaged solution and production data just in
case.
Comments
Post a Comment