Skip to content

Commit 314456a

Browse files
[Outlook] (equivalent add-ins) Clarify when to configure the Group Policy setting (#5011)
* Clarify use of GPO setting * Apply suggestion * Apply suggestion from review
1 parent c6e8858 commit 314456a

File tree

1 file changed

+8
-6
lines changed

1 file changed

+8
-6
lines changed

docs/develop/make-office-add-in-compatible-with-existing-com-add-in.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Make your Office Add-in compatible with an existing COM add-in
33
description: Enable compatibility between your Office Add-in and equivalent COM add-in.
4-
ms.date: 06/18/2024
4+
ms.date: 01/30/2025
55
ms.localizationpriority: medium
66
---
77

@@ -47,14 +47,16 @@ The following example shows the portion of the manifest that specifies a COM add
4747
```
4848

4949
> [!TIP]
50-
> For information about COM add-in and XLL UDF compatibility, see [Make your custom functions compatible with XLL user-defined functions](../excel/make-custom-functions-compatible-with-xll-udf.md). Not applicable for Outlook.
50+
>
51+
> - For information about COM add-in and XLL UDF compatibility, see [Make your custom functions compatible with XLL user-defined functions](../excel/make-custom-functions-compatible-with-xll-udf.md). Not applicable for Outlook.
52+
> - If you're unable to specify the **\<EquivalentAddins\>** element in the manifest of your Outlook web add-in, you must configure Group Policy instead. This only applies to Outlook. For guidance, see [Configure the Group Policy setting for Outlook add-ins](#configure-the-group-policy-setting-for-outlook-add-ins).
5153
52-
### Configure the Group Policy setting
54+
### Configure the Group Policy setting for Outlook add-ins
5355

54-
> [!IMPORTANT]
55-
> Applies to Outlook only.
56+
For Outlook web add-ins, if you're unable to update the add-in's manifest to specify the **\<EquivalentAddins\>** element, you must identify the equivalent COM add-in in the **Deactivate Outlook web add-ins whose equivalent COM or VSTO add-in is installed** Group Policy setting instead. This setting must be configured on the user's machine. Then, classic Outlook on Windows will use the COM add-in instead of the web add-in if they're both installed.
5657

57-
To declare compatibility between your Outlook web add-in and COM add-in, identify the equivalent COM add-in in the **Deactivate Outlook web add-ins whose equivalent COM or VSTO add-in is installed** Group Policy setting. This must be configured on the user's machine. Then, classic Outlook on Windows will use the COM add-in instead of the web add-in, if they're both installed.
58+
> [!NOTE]
59+
> Configuring the Group Policy setting isn't necessary if the add-in's manifest already contains an **\<EquivalentAddins\>** section.
5860
5961
1. Download the latest [Administrative Templates tool](https://www.microsoft.com/download/details.aspx?id=49030), paying attention to the tool's **Install Instructions**.
6062
1. Open the Local Group Policy Editor (**gpedit.msc**).

0 commit comments

Comments
 (0)