IconUrl element

Specifies the URL of the image that is used to represent your Office Add-in in the insertion UX and Office Store.

Add-in type: Content, Task pane, Mail


<IconUrl DefaultValue="string" />

Can contain



Attribute Type Required Description
DefaultValue string required Specifies the default value for this setting, expressed for the locale specified in the DefaultLocale element.


For a mail add-in, the icon is displayed in the File > Manage add-ins UI (Outlook) or Settings > Manage add-ins UI (Outlook on the web). For a content or task pane add-in, the icon is displayed in the Insert > Add-ins UI. For all add-in types, the icon is also used in AppSource, if you publish your add-in to AppSource.

The image must be in one of the following file formats: GIF, JPG, PNG, EXIF, BMP, or TIFF. For content and task pane apps, the image specified must be 32 x 32 pixels. For mail apps, the recommended image resolution is 64 x 64 pixels. You should also specify an icon for use with Office host applications running on high DPI screens using the HighResolutionIconUrl element. For more information, see the section Create a consistent visual identity for your app in Create effective listings in AppSource and within Office.

Changing the value of the IconUrl element at runtime is not currently supported.