Skip to content

Commit 82ecff4

Browse files
[All Hosts] (manifest) EquivalentAddin applies to VSTO too (#2309)
* [All Hosts] (manifest) EquivalentAddin applies to VSTO too * Apply suggestions from code review Co-authored-by: Sam Ramon <[email protected]> --------- Co-authored-by: Sam Ramon <[email protected]>
1 parent c3635c3 commit 82ecff4

File tree

5 files changed

+29
-19
lines changed

5 files changed

+29
-19
lines changed

docs/includes/equivalent-add-in-support-note.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
> [!IMPORTANT]
2-
> The equivalent add-in feature is supported by the following platform and applications. COM add-ins cannot be installed on any other platform, so on those platforms the manifest element that is discussed later in this article, `EquivalentAddins`, is ignored.
2+
> The equivalent add-in feature is supported by the following platform and applications. COM and VSTO add-ins can't be installed on any other platform, so on those platforms the manifest element that's discussed later in this article is ignored.
33
>
44
> - Excel, Word, and PowerPoint on Windows (Version 1904 or later)
55
> - Outlook on Windows (Version 2102 or later) against a supported Exchange server version

docs/manifest/equivalentaddin.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: EquivalentAddin element in the manifest file
3-
description: Specifies backwards compatibility for an equivalent COM add-in or XLL.
4-
ms.date: 01/04/2022
3+
description: Specifies backwards compatibility for an equivalent COM or VSTO add-in or XLL.
4+
ms.date: 07/12/2025
55
ms.localizationpriority: medium
66
---
77

88
# EquivalentAddin element
99

10-
Specifies backwards compatibility for an equivalent COM add-in or XLL.
10+
Specifies backwards compatibility for an equivalent COM add-in, VSTO add-in, or XLL.
1111

1212
[!INCLUDE [Support note for equivalent add-ins feature](../includes/equivalent-add-in-support-note.md)]
1313

@@ -43,9 +43,16 @@ For more information, see [Version overrides in the add-in only manifest](/offic
4343

4444
## Remarks
4545

46-
To specify a COM add-in as the equivalent add-in, provide both the `ProgId` and `Type` elements. To specify an XLL as the equivalent add-in, provide both the `FileName` and `Type` elements.
46+
To specify a COM or VSTO add-in as the equivalent add-in, provide both the `ProgId` and `Type` elements.
47+
48+
> [!NOTE]
49+
>
50+
> - Although the term "ProgId" is usually associated with only COM add-ins, in the manifest it refers to the name of either a COM or VSTO add-in.
51+
> - Use `COM` as the value of the `Type` element for both COM and VSTO add-ins.
52+
53+
To specify an XLL as the equivalent add-in, provide both the `FileName` and `Type` elements.
4754

4855
## See also
4956

5057
- [Make your custom functions compatible with XLL user-defined functions](/office/dev/add-ins/excel/make-custom-functions-compatible-with-xll-udf)
51-
- [Make your Office Add-in compatible with an existing COM add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)
58+
- [Make your Office Add-in compatible with an existing COM or VSTO add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)

docs/manifest/equivalentaddins.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: EquivalentAddins element in the manifest file
3-
description: Specifies backwards compatibility with an equivalent COM add-in, XLL, or both.
4-
ms.date: 01/04/2022
3+
description: Specifies backwards compatibility with one or more equivalent COM or VSTO add-ins or XLLs.
4+
ms.date: 07/12/2025
55
ms.localizationpriority: medium
66
---
77

88
# EquivalentAddins element
99

10-
Specifies backwards compatibility with an equivalent COM add-in, XLL, or both.
10+
Specifies compatibility with one or more equivalent COM add-ins, VSTO add-ins, or XLLs.
1111

1212
[!INCLUDE [Support note for equivalent add-ins feature](../includes/equivalent-add-in-support-note.md)]
1313

@@ -39,4 +39,4 @@ For more information, see [Version overrides in the add-in only manifest](/offic
3939
## See also
4040

4141
- [Make your custom functions compatible with XLL user-defined functions](/office/dev/add-ins/excel/make-custom-functions-compatible-with-xll-udf)
42-
- [Make your Office Add-in compatible with an existing COM add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)
42+
- [Make your Office Add-in compatible with an existing COM or VSTO add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)

docs/manifest/progid.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: ProgId element in the manifest file
3-
description: The ProgId element specifies the programmatic ID of the equivalent COM add-in for your web add-in's task pane.
4-
ms.date: 03/09/2021
3+
description: The ProgId element specifies the programmatic ID of the equivalent COM or VSTO add-in for your web add-in's task pane.
4+
ms.date: 07/12/2025
55
ms.localizationpriority: medium
66
---
77

88
# ProgId element
99

10-
Specifies the programmatic identifier of the equivalent COM add-in for the task pane of your web add-in.
10+
Specifies the name of the equivalent COM or VSTO add-in for your web add-in.
1111

1212
**Add-in type:** Task pane
1313

@@ -24,4 +24,4 @@ Specifies the programmatic identifier of the equivalent COM add-in for the task
2424
## See also
2525

2626
- [Make your custom functions compatible with XLL user-defined functions](/office/dev/add-ins/excel/make-custom-functions-compatible-with-xll-udf)
27-
- [Make your Office Add-in compatible with an existing COM add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)
27+
- [Make your Office Add-in compatible with an existing COM or VSTO add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)

docs/manifest/type.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Type element in the manifest file
3-
description: The Type element specifies if the equivalent add-in is a COM add-in or an XLL.
4-
ms.date: 03/09/2021
3+
description: The Type element specifies if the equivalent add-in is a COM or VSTO add-in or an XLL.
4+
ms.date: 07/12/2025
55
ms.localizationpriority: medium
66
---
77

88
# Type element
99

10-
Specifies if the equivalent add-in is a COM add-in or an XLL.
10+
Specifies if the equivalent add-in is a COM or VSTO add-in or an XLL.
1111

1212
**Add-in type:** Task pane, Custom function
1313

@@ -25,10 +25,13 @@ Specifies if the equivalent add-in is a COM add-in or an XLL.
2525

2626
You must specify one of the following values for the `Type` element.
2727

28-
- COM: Specifies the equivalent add-in is a COM add-in.
28+
- COM: Specifies the equivalent add-in is a COM or a VSTO add-in.
2929
- XLL: Specifies the equivalent add-in is an Excel XLL.
3030

31+
> [!IMPORTANT]
32+
> Use `COM` as the value of the `Type` element for both COM and VSTO add-ins.
33+
3134
## See also
3235

3336
- [Make your custom functions compatible with XLL user-defined functions](/office/dev/add-ins/excel/make-custom-functions-compatible-with-xll-udf)
34-
- [Make your Office Add-in compatible with an existing COM add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)
37+
- [Make your Office Add-in compatible with an existing COM or VSTO add-in](/office/dev/add-ins/develop/make-office-add-in-compatible-with-existing-com-add-in)

0 commit comments

Comments
 (0)