diff --git a/docs/manifest/equivalentaddins.md b/docs/manifest/equivalentaddins.md index 633f83afc7..667ec5ae84 100644 --- a/docs/manifest/equivalentaddins.md +++ b/docs/manifest/equivalentaddins.md @@ -1,7 +1,7 @@ --- title: EquivalentAddins element in the manifest file description: Specifies backwards compatibility with an equivalent COM add-in, XLL, or both. -ms.date: 01/04/2022 +ms.date: 06/12/2025 ms.localizationpriority: medium --- @@ -20,6 +20,9 @@ Specifies backwards compatibility with an equivalent COM add-in, XLL, or both. For more information, see [Version overrides in the add-in only manifest](/office/dev/add-ins/develop/xml-manifest-overview#version-overrides-in-the-manifest). +> [!NOTE] +> Some child elements are not valid in the Mail schemas. See [Can contain](#can-contain). + ## Syntax ```XML @@ -36,6 +39,41 @@ For more information, see [Version overrides in the add-in only manifest](/offic - [EquivalentAddin](equivalentaddin.md) +## Can contain + +The **\** element can contain the following child element. + +|Element|Content|Mail|TaskPane| +|:-----|:-----:|:-----:|:-----:| +|[Effect](#effect)|No|No|Yes| + +### Effect + +Specifies either that the COM add-in is disabled and hidden (instead of the Office Web Add-in) when they conflict, or specifies that the user chooses which to disable and hide. There are two possible values. + +- **DisableWithNotification**: All of the COM add-ins specified in the child **\** elements will be disabled and hidden. A popup dialog notifies the user that this happening. +- **UserOptionToDisable**: The user is prompted to choose whether to disable and hide COM add-ins specified in the child **\** elements or to disable and hide the Office Add-in. + +> [!NOTE] +> If the **\** element is not present, the COM add-ins are enabled and the Office Add-in is disabled and hidden on the Windows computer. + +The following is an example. The **\** element must be after all the **\** elements. + +```xml + + ... + + + ContosoCOMAddin + COM + + UserOptionToDisable + + +``` +> [!IMPORTANT] +> The **\** element is not available in Outlook. + ## See also - [Make your custom functions compatible with XLL user-defined functions](/office/dev/add-ins/excel/make-custom-functions-compatible-with-xll-udf)