Edit

Change the icon for a custom entity

  • Article

This topic applies to Dynamics 365 Customer Engagement (on-premises). For the Power Apps version of this topic, see: Change model-driven app custom entity icons

When you create a custom entity, it is automatically assigned a default icon, and all custom entities by default use the same icon. If your organization has several custom entities, it can be helpful to change the icon associated with one or more custom entities to help users differentiate them.

Note

You can’t modify the icons assigned to system entities.

You can upload two types of entity icons for each custom entity:

  • Icon in web application. This icon should be:

    • 16 x 16 pixels in size.

    • In .gif, .png, or .jpg format.

    • No larger than 10 kilobytes.

  • Icon for entity forms. This icon should be:

    • 32 x 32 pixels in size.

    • 16 colors.

    • In .ico format.

    • No larger than 10 kilobytes.

  1. Open solution explorer, expand Entities if necessary, select the custom entity you want to update the icon for, and then on the command bar, select Update Icons.

  2. In the Select New Icons dialog box, under Icon in Web application or Icon for Entity Forms, to the right of New Icon, select the Browse button Lookup button., select the appropriate image file, and then select OK.

  3. On the command bar, on the File menu, select Save.

  4. When your customizations are complete, publish them:

    • To publish customizations for only the component that you are currently editing, in the Navigation Pane, select the entity you have been working on, and then select Publish.

    • To publish customizations for all unpublished components at one time, in the Navigation Pane, select Entities, and then on the command bar, select Publish All Customizations.

      New icons might not display in the app until you close and reopen the it.

Note

Publishing customizations can interfere with normal system operation. We recommend you schedule publishing when it’s least disruptive to users.

Community tools

Iconator is a tool that XrmToolbox community developed for Dynamics 365 for Customer Engagement change-custom-entity-icons. Please see the Developer tools topic for community developed tools.

Note

The community tools are not a product of Microsoft Dynamics and does not extend support to the community tools. If you have questions pertaining to the tool, please contact the publisher. More Information: XrmToolBox.

See also

Create and edit entities