Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/develop/create-addin-commands-unified-manifest.md
Original file line number Diff line number Diff line change
Expand Up @@ -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](json-manifest-overview.md)
10 changes: 9 additions & 1 deletion docs/develop/unified-manifest-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/12/2025
ms.localizationpriority: high
---

Expand Down Expand Up @@ -75,6 +75,14 @@ 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

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/), 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.

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.
Expand Down
2 changes: 1 addition & 1 deletion docs/includes/non-unified-manifest-clients.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
> [!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 more information on client and platform support, see [Office Add-ins with the unified app manifest for Microsoft 365](../develop/unified-manifest-overview.md#client-and-platform-support).
Original file line number Diff line number Diff line change
@@ -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/12/2025
ms.localizationpriority: medium
---

Expand All @@ -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.<br><br>**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. |
Expand All @@ -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).
10 changes: 9 additions & 1 deletion docs/outlook/outlook-mobile-addins.md
Original file line number Diff line number Diff line change
@@ -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/12/2025
ms.localizationpriority: medium
---

Expand Down Expand Up @@ -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.
Expand Down