Modify the icons for an entity


Updated: November 29, 2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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 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 Help & Training: Change entity icons.

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




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 Microsoft Dynamics 365.

  • 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 Microsoft Dynamics CRM 4.0.

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright