diff --git a/docs/develop/create-addin-commands-unified-manifest.md b/docs/develop/create-addin-commands-unified-manifest.md index ed25268a56..c37439cde5 100644 --- a/docs/develop/create-addin-commands-unified-manifest.md +++ b/docs/develop/create-addin-commands-unified-manifest.md @@ -599,4 +599,4 @@ You've now completed adding a menu to your add-in. [Sideload and test it](../tes ## See also - [Add-in commands](../design/add-in-commands.md) -- [Unified manifest for Microsoft 365](json-manifest-overview.md). +- [Unified manifest for Microsoft 365](unified-manifest-overview.md) diff --git a/docs/develop/unified-manifest-overview.md b/docs/develop/unified-manifest-overview.md index 0028c38e55..a7f2236999 100644 --- a/docs/develop/unified-manifest-overview.md +++ b/docs/develop/unified-manifest-overview.md @@ -2,7 +2,7 @@ title: Office Add-ins with the unified app manifest for Microsoft 365 description: Get an overview of the unified app manifest for Microsoft 365 for Office Add-ins and its uses. ms.topic: overview -ms.date: 02/12/2025 +ms.date: 06/19/2025 ms.localizationpriority: high --- @@ -75,6 +75,27 @@ There is a `"validDomains"` array in the manifest file that is used to tell Offi To override this behavior in desktop platforms, add each domain you want to open in the add-in window to the list of domains specified in the `"validDomains"` array. If the add-in tries to go to a URL in a domain that is in the list, then it opens in the task pane in both Office on the web and desktop. If it tries to go to a URL that isn't in the list, then in Office on desktop, that URL opens in a new browser window (outside the add-in task pane). +## Client and platform support + +Add-ins that use the unified manifest can be installed if the Office platform *directly* supports it. + +To run an add-in on platforms that don't directly support the unified manifest, you must publish the add-in to [AppSource](https://appsource.microsoft.com/). When the app package that contains the unified manifest is deployed in AppSource, an add-in only manifest is generated from the unified manifest and stored. This add-in only manifest is then used to install the add-in on platforms that don't directly support the unified manifest. + +The following tables lists which Office platforms directly support add-ins that use the unified manifest. + +| Client/platform | Support for add-ins with the unified manifest| +| ----- | ----- | +| Office on the web | Directly supported | +| Office on Windows (Version 2304 (Build 16320.00000) or later) connected to a Microsoft 365 subscription | Directly supported | +| [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) | Directly supported | +| Office on Windows (prior to Version 2304 (Build 16320.00000)) connected to a Microsoft 365 subscription | Not directly supported | +| Office on Windows (perpetual versions) | Not directly supported | +| Office on Mac | Not directly supported | +| Office on mobile | Not directly supported | + +> [!NOTE] +> If you're deploying an add-in in the [Microsoft 365 Admin Center](../publish/publish.md) and require it to run on platforms that don't directly support the unified manifest, the add-in must be a published AppSource add-in. Custom add-ins or line-of-business (LOB) add-ins that use the unified manifest can't currently be deployed in the Microsoft 365 Admin Center. + ## Sample unified manifest The following is an example of a unified app manifest for an add-in. It doesn't contain every possible manifest property. diff --git a/docs/includes/non-unified-manifest-clients.md b/docs/includes/non-unified-manifest-clients.md index 88c1939cba..f9eba29e08 100644 --- a/docs/includes/non-unified-manifest-clients.md +++ b/docs/includes/non-unified-manifest-clients.md @@ -1,4 +1,2 @@ > [!NOTE] -> Office Add-ins that use the unified manifest for Microsoft 365 are *directly* supported in Office on the web, in [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627), and in Office on Windows connected to a Microsoft 365 subscription, Version 2304 (Build 16320.00000) or later. -> -> When the app package that contains the unified manifest is deployed in [AppSource](https://appsource.microsoft.com/) or the [Microsoft 365 Admin Center](../publish/publish.md) then an add-in only manifest is generated from the unified manifest and stored. This add-in only manifest enables the add-in to be installed on platforms that don't directly support the unified manifest, including Office on Mac, Office on mobile, subscription versions of Office on Windows earlier than 2304 (Build 16320.00000), and perpetual versions of Office on Windows. +> For information on clients and platforms that *directly* support Office Add-ins that use the unified manifest for Microsoft 365, see [Office Add-ins with the unified app manifest for Microsoft 365](../develop/unified-manifest-overview.md#client-and-platform-support). diff --git a/docs/outlook/compare-outlook-add-in-support-in-outlook-for-mac.md b/docs/outlook/compare-outlook-add-in-support-in-outlook-for-mac.md index e7f90d22a0..55eea2e5f9 100644 --- a/docs/outlook/compare-outlook-add-in-support-in-outlook-for-mac.md +++ b/docs/outlook/compare-outlook-add-in-support-in-outlook-for-mac.md @@ -1,7 +1,7 @@ --- title: Compare Outlook add-in support in Outlook on Mac description: Learn how add-in support in Outlook on Mac compares with other Outlook clients. -ms.date: 02/29/2024 +ms.date: 06/19/2025 ms.localizationpriority: medium --- @@ -11,8 +11,6 @@ You can create and run an Outlook add-in the same way in Outlook on Mac as in th For more information, see [Deploy and install Outlook add-ins for testing](testing-and-tips.md). -For information about new UI support, see [Add-in support in Outlook on new Mac UI](#add-in-support-in-outlook-on-new-mac-ui). - | Area | Outlook on the web, Windows (new and classic), and mobile devices | Outlook on Mac | |:-----|:-----|:-----| | Supported versions of office.js| All APIs in Office.js. | All APIs in Office.js.

**NOTE**: In Outlook on Mac, only Version 16.35 (20030802) or later supports saving a meeting. Otherwise, the `saveAsync` method fails when called from a meeting in compose mode. See [Cannot save a meeting as a draft in Outlook for Mac by using Office JS API](https://support.microsoft.com/help/4505745) for a workaround. | @@ -39,3 +37,11 @@ You can determine which UI version you're on, as follows: **New UI** ![New UI on Mac.](../images/outlook-on-mac-new.png) + +## Support for add-ins with the unified manifest for Microsoft 365 + +Add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md) aren't directly supported in Outlook on Mac. To run this type of add-in, it must first be published to [AppSource](https://appsource.microsoft.com/). An add-in only manifest is then generated from the unified manifest, which enables the add-in to be installed in Outlook on Mac. + +If you're deploying an add-in that uses the unified manifest in the [Microsoft 365 Admin Center](../publish/publish.md) and require it to run in Outlook on Mac, the add-in must be a published AppSource add-in. Custom add-ins or line-of-business (LOB) add-ins that use the unified manifest can't currently be deployed in the Microsoft 365 Admin Center. + +For more information, see the "Client and platform support" section of [Office Add-ins with the unified app manifest for Microsoft 365](../develop/unified-manifest-overview.md#client-and-platform-support). diff --git a/docs/outlook/outlook-mobile-addins.md b/docs/outlook/outlook-mobile-addins.md index 964fe31aaa..9136e9202f 100644 --- a/docs/outlook/outlook-mobile-addins.md +++ b/docs/outlook/outlook-mobile-addins.md @@ -1,7 +1,7 @@ --- title: Add-ins for Outlook on mobile devices description: Outlook mobile add-ins are supported on all Microsoft 365 business accounts and Outlook.com accounts. -ms.date: 10/17/2024 +ms.date: 06/19/2025 ms.localizationpriority: medium --- @@ -73,6 +73,14 @@ Here are examples of scenarios that make sense in Outlook mobile. ![Animated GIF showing user interaction with an add-in in Outlook on Android.](../images/outlook-mobile-addin-interaction-android.gif) +## Support for add-ins with the unified manifest for Microsoft 365 + +Add-ins that use the [unified manifest for Microsoft 365](../develop/unified-manifest-overview.md) aren't directly supported in Outlook on mobile devices. To run this type of add-in, it must first be published to [AppSource](https://appsource.microsoft.com/). An add-in only manifest is then generated from the unified manifest, which enables the add-in to be installed in Outlook mobile. + +If you're deploying an add-in that uses the unified manifest in the [Microsoft 365 Admin Center](../publish/publish.md) and require it to run in Outlook mobile, the add-in must be a published AppSource add-in. Custom add-ins or line-of-business (LOB) add-ins that use the unified manifest can't currently be deployed in the Microsoft 365 Admin Center. + +For more information, see the "Client and platform support" section of [Office Add-ins with the unified app manifest for Microsoft 365](../develop/unified-manifest-overview.md#client-and-platform-support). + ## Testing your add-ins on mobile To test an add-in on Outlook mobile, first [sideload an add-in](sideload-outlook-add-ins-for-testing.md) using a Microsoft 365 or Outlook.com account in Outlook on the web, on Windows ([new](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627) or classic), or on Mac. Make sure your manifest is properly formatted to contain `MobileFormFactor` or it won't load in Outlook mobile.