Delete a custom entity

This topic applies to Dynamics 365 Customer Engagement (on-premises). For the Power Apps version of this topic, see: Delete an entity

As someone with the system administrator security role, you can delete custom entities that aren’t part of a managed solution.

Important

When you delete a custom entity, the database tables that store data for that entity are deleted and all data they contain is lost. Any associated records that have a parental relationship to the custom entity are also deleted. For more information about parental relationships, see Create and edit entity relationships.

Before you can delete a custom entity, you must remove any dependencies that exist in other solution components. For example, if another entity has a lookup field on a form that uses this custom entity, you must first remove that field from the form before you can delete the custom entity. This also applies to views defined for other entities that include a reference to this entity. If you try to delete the entity and any dependencies are discovered, the deletion won’t be allowed. Select Show Dependencies on the menu bar to help identify any dependencies that you have to remove before the entity can be deleted.

The only way to recover data from an entity that was deleted is to restore the database from a point before the entity was deleted.

See also

Create or edit an entity