Skip to content

Commit b554112

Browse files
authored
[All Hosts] (devx) Clarify optional/required status of icon url elements (#2343)
* [All Hosts] (devx) Clarify optional/required status of icon url elements * metadata date * fix link
1 parent a287f85 commit b554112

File tree

3 files changed

+17
-6
lines changed

3 files changed

+17
-6
lines changed

docs/manifest/highresolutioniconurl.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,17 @@
11
---
22
title: HighResolutionIconUrl element in the manifest file
33
description: Specifies the URL of the image that is used to represent your Office Add-in in the insertion UX and Office Store on high DPI screens.
4-
ms.date: 03/30/2021
4+
ms.date: 09/08/2025
55
ms.localizationpriority: medium
66
---
77

88
# HighResolutionIconUrl element
99

10-
Specifies the URL of the image that is used to represent your Office Add-in in the insertion UX and Office Store on high DPI screens.
10+
Specifies the URL of the image that is used to represent your Office Add-in in the insertion UX, [AppSource](https://appsource.microsoft.com), and the vertical task pane tab bar on high DPI screens.
11+
12+
> [!IMPORTANT]
13+
> This element, and the [IconUrl](iconurl.md) element, are now required for add-ins distributed in [AppSource](https://appsource.microsoft.com).
14+
1115

1216
**Add-in type:** Content, Task pane, Mail
1317

docs/manifest/iconurl.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,17 @@
11
---
22
title: IconUrl element in the manifest file
33
description: The IconUrl element specifies the URL of the image that represents your Office Add-in in the insertion UX, AppSource, and the tab bar.
4-
ms.date: 06/19/2024
4+
ms.date: 09/08/2025
55
ms.localizationpriority: medium
66
---
77

88
# IconUrl element
99

1010
Specifies the full, absolute URL of the image that is used to represent your Office Add-in in the insertion UX, [AppSource](https://appsource.microsoft.com), and the vertical task pane tab bar.
1111

12+
> [!IMPORTANT]
13+
> This element, and the [HighResolutionIconUrl](highresolutioniconurl.md) element, are now required for add-ins distributed in [AppSource](https://appsource.microsoft.com).
14+
1215
**Add-in type:** Content, Task pane, Mail
1316

1417
## Syntax

docs/manifest/officeapp.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: OfficeApp element in the manifest file
33
description: The OfficeApp element is the root element of an Office Add-in manifest.
4-
ms.date: 11/06/2020
4+
ms.date: 09/08/2025
55
ms.localizationpriority: medium
66
---
77

@@ -50,8 +50,8 @@ The **\<OfficeApp\>** element can contain the following child elements depending
5050
|Element|Content|Mail|TaskPane|
5151
|:-----|:-----:|:-----:|:-----:|
5252
|[AlternateId](alternateid.md)|Yes|Yes|Yes|
53-
|[IconUrl](iconurl.md)|Yes|Yes|Yes|
54-
|[HighResolutionIconUrl](highresolutioniconurl.md)|Yes|Yes|Yes|
53+
|[IconUrl](iconurl.md)\*|Yes|Yes|Yes|
54+
|[HighResolutionIconUrl](highresolutioniconurl.md)\*|Yes|Yes|Yes|
5555
|[SupportUrl](supporturl.md)|Yes|Yes|Yes|
5656
|[AppDomains](appdomains.md)|Yes|Yes|Yes|
5757
|[Hosts](hosts.md)|Yes|Yes|Yes|
@@ -63,6 +63,10 @@ The **\<OfficeApp\>** element can contain the following child elements depending
6363
|[VersionOverrides](versionoverrides.md)|Yes|Yes|Yes|
6464
|[ExtendedOverrides](extendedoverrides.md)|No|No|Yes|
6565

66+
>
67+
> [!IMPORTANT]
68+
> \* The [IconUrl](iconurl.md) and [HighResolutionIconUrl](highresolutioniconurl.md) elements are formally optional, but are now required for add-ins distributed in [AppSource](https://appsource.microsoft.com).
69+
6670
## Attributes
6771

6872
|Attribute|Description|

0 commit comments

Comments
 (0)