Change 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:
Important
Before you begin this task, be sure that you have uploaded as web resources any custom icons that you intend to assign. More information: Add or edit a form web resource
-
Make sure that you have the System Administrator or System Customizer security role or equivalent permissions.
Check your security role
-
Go to Settings > Customizations.
-
Click Customize the System.
-
Expand Entities if necessary, select the custom entity you want to update the icon for, and then on the command bar, click Update Icons.
-
In the Select New Icons dialog box, under Icon in Web application or Icon for Entity Forms, to the right of New Icon, click the Browse button
, select the appropriate image file, and then click OK.
-
On the command bar, on the File menu, click Save.
-
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 click Publish.
-
To publish customizations for all unpublished components at one time, in the Navigation Pane, click Entities, and then on the command bar, click Publish All Customizations.
New icons might not display in Microsoft Dynamics 365 until you close and reopen the Microsoft Dynamics 365 client.
Note
Publishing customizations can interfere with normal system operation. We recommend you schedule publishing when it’s least disruptive to users.