Modify the icons for an entity

Applies to Dynamics 365 for Customer Engagement apps version 9.x

When you create a new entity, default icons are provided. You can change the icons of custom entities by creating image Web resources and updating EntityMetadata (EntityMetadata EntityType or EntityMetadata class) properties. Use the specifications in this topic when creating or ordering icons. You will need the icon files before you begin.


When you first associate Web Resources with icons in the application the size of the icons will be checked. If you associate Web Resources programmatically, no size validation occurs. If the Web Resource is later updated with a large size image, no validation occurs.

For more information about how to manually update icons, see Change entity icons.

Types of icons

The following table liststhe types of entity icons you can update.

Type Specifications Property
Icon in Web application

Displays when records for this entity are displayed in a grid.
- 16x16px
- Less than 10k
Icon for Entity Forms - 32x32px
- Less than 10k
This size icon is not used in Dynamics 365 for Customer Engagement Customer Engagement. - 66x48px
- Less than 10k

PNG Web resources are recommended because they support transparency and good compression with a better color fidelity than GIF. GIF, JPG, and ICO formats are supported for backwards compatibility when organizations are upgraded from Dynamics CRM 4.0.

See also

Customize Entity Metadata
Modify Entity Messages