Skip to main content

Convert an existing Unmanaged solution in a Dynamics 365 CRM production environment into a Managed solution without affecting existing Data

Key Principles

  1. 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.
  2. 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

  1. Go to Settings → Solutions in Production (or Dev environment if that’s safer first).
  2. Open your unmanaged solution.
  3. Click Export.
  4. Choose Managed instead of Unmanaged.
  5. Follow the wizard and export the .zip file.
  6. 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

  1. Navigate to the environment where you want to import.
  2. Go to Settings → Solutions → Import.
  3. Select the exported managed solution zip file.
  4. D365 will check dependencies.
  5. 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:
    1. Maintain all unmanaged customizations in a Dev or Sandbox environment.
    2. Export managed solution from Sandbox.
    3. 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:

  1. Always export from a sandbox.
  2. Include all entities, fields, forms, views, processes.
  3. Mark the solution managed during export.
  4. Import to Production — all live data stays untouched.

 

 

 


Key Points 

  1. Data Safety
    • Importing a managed solution does not delete or modify existing records in entities unless you delete the entity itself (which we avoid).
  2. Solution Read-Only
    • Once imported, the managed solution components cannot be edited in Production directly.
    • Only unmanaged components outside the solution can be modified.
  3. Dependencies
    • If your solution uses other entities or solutions, Dynamics 365 will prompt for dependencies before import.
  4. 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

Popular posts from this blog

Automation using Azure DevOps for Dynamics 365 CE / CRM / Dataverse

In enterprise Dynamics 365 CE / CRM / Dataverse projects, manual deployments create long-term problems such as: inconsistent releases missing components in Production unmanaged customization pollution deployment failures due to dependencies rollback complexity lack of traceability That is why modern organizations implement Azure DevOps automation for Dynamics 365 CE / CRM using CI/CD pipelines. This blog explains how to architect a complete automation strategy using Azure DevOps for D365 CRM projects. Why Azure DevOps for D365 CRM? Azure DevOps provides: version control (Git repos) build & release pipelines approvals and governance artifact management deployment automation integration with Power Platform tools 📌 Architect Callout If you don’t have CI/CD, you don’t have enterprise ALM. 1. Target ALM Architecture (Enterprise Standard) Recommended Environment Setup A proper CRM ALM environment chain: ...

Solution Layering in Dynamics 365 CE / CRM / Dataverse (Managed vs Unmanaged Explained)

Solution layering is one of the most misunderstood concepts in Dynamics 365 CE / CRM / Dataverse . Many production issues happen because architects and developers don’t fully understand which customization “wins” when multiple solutions modify the same component. This blog explains solution layering in a simple and practical way. ✅ What is Solution Layering? Solution layering means: When multiple solutions modify the same component (form, field, view, etc.), Dataverse decides which customization is applied based on the solution layer order. Every customization sits on a “layer”. 🔥 Types of Layers in D365 There are two major types: 1. Unmanaged Layer Created when you customize directly in the environment Highest priority (usually overrides managed) 2. Managed Layer Created when you import a managed solution Multiple managed solutions can stack on each other 📌 Architect Callout: Unmanaged layer is like “local override”. ...

Architecting Beyond the Box: D365 CE, Power Platform & Azure in the Real World

  Architecting Beyond the Box: D365 CE, Power Platform & Azure in the Real World In most enterprise programs, Dynamics 365 CE and the Power Platform are not the system—they are part of a much larger digital ecosystem. CRM is expected to orchestrate processes, surface insights, integrate with core platforms, and scale with the business. This is where architecture matters more than features. As architects, our job is not to “make it work,” but to make it sustainable . The Common Trap: Overloading the Platform A frequent anti-pattern I see is treating Dataverse and Power Apps as a full replacement for enterprise integration or processing layers: Heavy synchronous plugins for complex business logic Power Automate flows performing batch processing CRM used as a reporting engine Direct point-to-point integrations between systems It works—until it doesn’t. You start seeing: Timeouts in plugins and flows API throttling ...