Symptom

When attempting to delete a solution in Dynamics 365, you encounter the following error:

"Solution [solution name] cannot be deleted due to dependencies from other components in the system. Remove all dependencies to allow for solution deletion."

You may also see a reference to error code 8004f01d.

NOTE: If the error dialog does not display any dependencies, check the Solution History which may contain additional error details.

Cause

This error occurs if you try to delete a solution that is referenced by other components in your Dynamics 365 organization. A solution cannot be removed until all dependencies on that solution have been removed.

Resolution

The error dialog displays the list of dependencies that need to be removed before you can successfully delete the solution. Click the link in the Required By column to view the dependent component. Either delete the component if it is no longer needed or modify it to remove any references to the solution you are trying to delete.

Examples

  • Unmanaged Customizations

If you import a solution and then add references to one or more of those components in the default solution, you need to remove those references to successfully delete the solution.

IMPORTANT: After removing the reference, publish customizations for the changes to take effect.

Below are a few common examples:

  • Process (ex. Workflow)

If the solution you are trying to delete includes a custom entity called Widget and you created a workflow process that references the Widget entity, either delete the workflow (if no longer needed) or update the workflow to remove the reference to the Widget entity. For example: If the workflow includes multiple steps and one of the steps creates or updates a Widget record, remove this step from the workflow and save your changes.

  • Site Map (navigation)

If the solution you are trying to delete includes a custom entity called Widget and you modified your Site Map (navigation) to display this custom entity, you need to remove the reference to this entity from your Site Map before you can successfully delete the solution. If this reference was made in the Default Solution, follow these steps:

1. Navigate to Settings, click Customization, and click Customize the System.

2. Expand Entities.

3. Locate and click on the name of the custom entity. 

4. Remove any checkmarks from the Areas that display this entity section.

5. Click Save and then click Publish.

For information about modifying your Site Map, see Change application navigation using the SiteMap.

  • System Form

If the solution you are trying to delete added a custom field (ex. NewField) to the Contact entity and you modified one of the Contact forms to display this field, you need to remove the reference to this field from your form before you can successfully delete the solution.

  • View

If the solution you are trying to delete added a custom field (ex. NewField) to the Contact entity and you modified one of the Contact views to display this field, you need to remove the reference to this field from the view before you can successfully delete the solution.

  • Parent/Child Solutions

It is possible for a solution to depend on other solutions. For example: Assume you installed an ISV package from Contoso which included multiple solutions. Solution A introduces a new custom entity called Widget and Solution B introduces additional entities as well as some modifications to the Widget entity. Solution B is dependent on Solution A. If you try to delete Solution A before deleting Solution B, the solution will fail to be deleted because of the dependencies. 

Need more help?

Expand your skills
Explore Training
Get new features first
Join Microsoft Insiders

Was this information helpful?

What affected your experience?

Any additional feedback? (Optional)

Thank you for your feedback!

×