Edit an entity

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

You can edit any custom entity that you create. System entities or managed custom entities may have limitations about changes you can make.

System entities are any entities that are included with your environment. Managed custom entities are entities that have been added to the system by importing a managed solution. The degree to which you can edit these entities is determined by the managed properties set for each entity. Any properties that can’t be edited will be disabled. To view the Managed properties for an entity selected in the solution explorer, select Managed Properties on the menu bar.


You must publish customizations after you save changes to an existing entity. More information: Publishing Customizations

When you edit entities you can make the following metadata changes:

Change the name of an entity

Use the Display Name and Plural Name properties to change the name of the entity in the application. However, the name of many system entities may also be used in other text in the application. To locate and change text where this name was used, see Edit system entity messages.

Change the icons used for custom entities

By default, all custom entities in the web application have the same icons. You can create image web resources for the icons you want for your custom entities and set them using the Update Icons button on the toolbar. There are two sizes of icons:

  • Icon in Web Application This icon should be 16x16 pixels.

  • Icon for Entity Forms This icon should be 32x32 pixels.

    Both icons should be no larger than 10 KB. PNG format files with transparent backgrounds are recommended. More information: Change icons for custom entities.


Dynamics 365 for tablets and Dynamics 365 for phones don’t display custom icons for custom entities.

Entity options that can only be enabled

The following table lists the options that you can enable for an entity, but after these items are enabled, they can’t be disabled:

Option Description
Business process flows Create business process flows for this entity. More information: Create a business process flow to standardize processes
Notes Append notes to records for this entity. Notes include the ability to add attachments.
Activities Associate activities to records for this entity.
Connections Use the connections feature to show how records for this entity have connections to records of other entities that also have connections enabled.
Sending e-mail (if an e-mail field does not exist, one will be created) Send emails using an email address stored in one of the fields for this entity. If a Single Line of Text field with format set to email doesn’t already exist for this entity, a new one will be created when you enable sending email.
Queues Use the entity with queues. Queues improve routing and sharing of work by making records for this entity available in a central place that everyone can access.

Enable or disable entity options

The following table lists the entity options that you can enable or disable at any time.

Option Description
Primary Image System entities that support images will already have an Image field. You can choose whether to display data in this field as the image for the record by setting this field to [None] or Default Image.

For custom entities you must first create an image field. Each entity can have only one image field. After you create one, you can change this setting to set the primary image. More information: Image fields
Mail Merge People can use this entity with mail merge.
Document Management After other tasks have been performed to enable document management for your organization, enabling this feature allows for this entity to participate in integration with SharePoint. More information: Set up SharePoint integration
Duplicate Detection If duplicate detection is enabled for your organization, enabling this allows you to create duplicate detection rules for this entity. For information about enabling duplicate detection, see Turn duplicate detection rules on or off for the whole organization.
Allow Quick Create After you have created and published a Quick Create Form for this entity, people will have the option to create a new record using the Create button in the navigation pane. More information: Create and design forms

When this is enabled for a custom activity entity, the custom activity will be visible in the group of activity entities when people use the Create button in the navigation pane. However, because activities don’t support quick create forms, the main form will be used when the custom entity icon is clicked.
Auditing When auditing is enabled for your organization, this allows for changes to entity records to be captured over time. When you enable auditing for an entity, auditing is also enabled on all its fields. You can select or clear fields that you want to enable auditing on.
Access Teams Create team templates for this entity. More information: About team templates
Enable for phone express Make this entity available to the Dynamics 365 for phones app.
Enable for mobile Make this entity available to the Dynamics 365 for phones and tablets apps. You also have the option to make this entity Read-only in mobile.

If the forms for an entity require an extension not supported in Customer Engagement for phones and tablets, such as iFrame or web resource controls, use this setting to ensure that mobile app users can’t edit the data for these entities.

Important: If you have previously installed any portal solution, to create a case in the Customer Service Hub or to use the Merge cases command, you must turn off the Read-only in mobile option for the Case entity.

See also

Create or edit an entity (overview)