[Outlook] (unified manifest) Document unified manifest support in Outlook on Mac and on mobile (#5303)

samantharamon · web-flow · commit 3337c9fc80de · 2025-08-01T15:55:21.000-07:00
* Add note about unified manifest support in Outlook on Mac and on mobile

* Fix typo and links

* Clarify support information and dates

* Apply suggestion from review
diff --git a/docs/develop/event-based-activation.md b/docs/develop/event-based-activation.md
diff --git 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: 06/24/2025
+ms.date: 08/01/2025
 ms.localizationpriority: high
 ---
 
@@ -79,7 +79,7 @@ To override this behavior in desktop platforms, add each domain you want to open
 
 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.
+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/). Then, deploy the add-in in the [Microsoft 365 Admin Center](../publish/publish.md). This way, an add-in only manifest is generated from the unified manifest and stored. The 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.
 
diff --git a/docs/includes/outlook-unified-manifest-mac.md b/docs/includes/outlook-unified-manifest-mac.md
@@ -0,0 +1,2 @@
+> [!NOTE]
+> Add-ins that use the unified manifest for Microsoft 365 aren't directly supported in Outlook on Mac. To run this type of add-in on Mac, the add-in must first be published to [AppSource](https://appsource.microsoft.com/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). For more information, see [Support for add-ins with the unified manifest for Microsoft 365](../outlook/compare-outlook-add-in-support-in-outlook-for-mac.md#support-for-add-ins-with-the-unified-manifest-for-microsoft-365).
diff --git a/docs/includes/outlook-unified-manifest-mobile.md b/docs/includes/outlook-unified-manifest-mobile.md
@@ -0,0 +1,2 @@
+> [!NOTE]
+> Add-ins that use the unified manifest for Microsoft 365 aren't directly supported in Outlook on mobile devices. To run this type of add-in on mobile platforms, the add-in must first be published to [AppSource](https://appsource.microsoft.com/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). For more information, see [Support for add-ins with the unified manifest for Microsoft 365](../outlook/outlook-mobile-addins.md#support-for-add-ins-with-the-unified-manifest-for-microsoft-365).
diff --git a/docs/includes/outlook-unified-manifest-platforms.md b/docs/includes/outlook-unified-manifest-platforms.md
@@ -0,0 +1,2 @@
+> [!NOTE]
+> Add-ins that use the unified manifest for Microsoft 365 aren't directly supported in Outlook on Mac and on mobile devices. To run this type of add-in on Mac and on mobile platforms, the add-in must first be published to [AppSource](https://appsource.microsoft.com/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). 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/add-mobile-support.md b/docs/outlook/add-mobile-support.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Add support for add-in commands in Outlook on mobile devices
 description: Learn how to add support for Outlook on mobile devices including how to update the add-in manifest and change your code for mobile scenarios, if necessary.
-ms.date: 01/31/2025
+ms.date: 08/01/2025
 ms.localizationpriority: medium
 ---
 
@@ -15,6 +15,8 @@ The first step to enabling add-in commands in Outlook mobile is to define them i
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-mobile](../includes/outlook-unified-manifest-mobile.md)]
+
 1. In the [`"extensions.ribbons.requirements.formFactors"`](/microsoft-365/extensibility/schema/requirements-extension-element#formfactors) array, add `"mobile"` as an item. When you are finished, the array should look like the following.
 
     ```json
diff --git a/docs/outlook/append-on-send.md b/docs/outlook/append-on-send.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Prepend or append content to a message or appointment body on send
 description: Learn how to prepend or append content to a message or appointment body when the mail item is sent.
-ms.date: 07/18/2024
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -29,6 +29,8 @@ To configure the manifest, select the tab for the type of manifest you'll use.
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-mac](../includes/outlook-unified-manifest-mac.md)]
+
 The following shows how to configure your unified manifest to enable the prepend-on-send and append-on-send features.
 
 1. Open the **manifest.json** file.
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
@@ -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: 06/19/2025
+ms.date: 08/01/2025
 ms.localizationpriority: medium
 ---
 
@@ -40,8 +40,9 @@ You can determine which UI version you're on, as follows:
 
 ## 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.
+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/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). 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.
+> [!NOTE]
+> 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/contextless.md b/docs/outlook/contextless.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Activate your Outlook add-in without the Reading Pane enabled or a message selected
 description: Learn how to activate your Outlook add-in without enabling the Reading Pane or first selecting a message.
-ms.date: 04/12/2024
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -27,6 +27,8 @@ The steps to configure the manifest vary depending on which type of manifest you
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-mac](../includes/outlook-unified-manifest-mac.md)]
+
 1. In your preferred code editor, open the [Outlook quick start](../quickstarts/outlook-quickstart-json-manifest.md) project that you created.
 
 1. Open the **manifest.json** file located at the root of the project.
diff --git a/docs/outlook/mobile-event-based.md b/docs/outlook/mobile-event-based.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Implement event-based activation in Outlook mobile add-ins
 description: Learn how to develop an Outlook mobile add-in that implements event-based activation.
-ms.date: 06/12/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -33,11 +33,14 @@ To run the feature, you must have a supported version of Outlook on Android or o
 
 The steps for configuring the manifest depend on which type of manifest you selected in the quick start.
 
-> [!NOTE]
-> When developing an event-based add-in to run in Outlook on Android and on iOS, note that the unified app manifest for Microsoft 365 can only be used if the add-in handles certain events. To learn which events are supported, see [Supported events and clients](#supported-events-and-clients).
-
 # [Unified app manifest for Microsoft 365](#tab/jsonmanifest)
 
+> [!NOTE]
+>
+> - When developing an event-based add-in to run in Outlook on Android and on iOS, note that the unified manifest for Microsoft 365 can only be used if the add-in handles certain events. To learn which events are supported, see [Supported events and clients](#supported-events-and-clients).
+>
+> - Add-ins that use the unified manifest for Microsoft 365 aren't directly supported in Outlook on mobile devices. To run this type of add-in on mobile platforms, the add-in must first be published to [AppSource](https://appsource.microsoft.com/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). For more information, see [Support for add-ins with the unified manifest for Microsoft 365](outlook-mobile-addins.md#support-for-add-ins-with-the-unified-manifest-for-microsoft-365).
+
 1. Configure the [`"extensions.runtimes"`](/microsoft-365/extensibility/schema/extension-runtimes-array?view=m365-app-prev&preserve-view=true) property just as you would for setting up a function command. For details, see [Configure the runtime for the function command](../develop/create-addin-commands-unified-manifest.md#configure-the-runtime-for-the-function-command).
 
 1. In the [`"extensions.ribbons.contexts"`](/microsoft-365/extensibility/schema/extension-ribbons-array#contexts) array, add `mailRead` as an item. When you're finished, the array should look like the following.
diff --git a/docs/outlook/mobile-log-appointments.md b/docs/outlook/mobile-log-appointments.md
@@ -1,7 +1,7 @@
 ---
 title: Log appointment notes to an external application in Outlook mobile add-ins
 description: Learn how to set up an Outlook mobile add-in to log appointment notes and other details to an external application.
-ms.date: 01/07/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -31,6 +31,8 @@ To configure your add-in's manifest, select the type of manifest you're using.
 
 ### Unified manifest for Microsoft 365
 
+[!INCLUDE [outlook-unified-manifest-mobile](../includes/outlook-unified-manifest-mobile.md)]
+
 # [Function command](#tab/noui)
 
 1. Open the quick start project in your code editor.
diff --git a/docs/outlook/on-new-compose-events-walkthrough.md b/docs/outlook/on-new-compose-events-walkthrough.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Automatically set the subject of a new message or appointment
 description: Learn how to implement an event-based add-in that automatically sets the subject of a new message or appointment.
-ms.date: 06/12/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -27,6 +27,8 @@ To configure the manifest, select the tab for the type of manifest you're using.
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-platforms](../includes/outlook-unified-manifest-platforms.md)]
+
 1. Open the **manifest.json** file.
 
 1. Navigate to the [`"authorization.permissions.resourceSpecific"`](/microsoft-365/extensibility/schema/root-authorization-permissions#resourcespecific) array. In the array object, replace the value of the `"name"` property with `"MailboxItem.ReadWrite.User"`. This is needed by the add-in to be able to set the subject of the mail item.
diff --git a/docs/outlook/online-meeting.md b/docs/outlook/online-meeting.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Create an Outlook add-in for an online-meeting provider
 description: Discusses how to set up an Outlook add-in for an online-meeting service provider.
-ms.date: 12/16/2024
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -25,6 +25,8 @@ The steps for configuring the manifest depend on which type of manifest you sele
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-platforms](../includes/outlook-unified-manifest-platforms.md)]
+
 1. Open the **manifest.json** file.
 
 1. Find the *first* object in the [`"authorization.permissions.resourceSpecific"`](/microsoft-365/extensibility/schema/root-authorization-permissions#resourcespecific) array and set its `"name"` property to `"MailboxItem.ReadWrite.User"`. It should look like this when you're done.
diff --git a/docs/outlook/onmessagefromchanged-onappointmentfromchanged-events.md b/docs/outlook/onmessagefromchanged-onappointmentfromchanged-events.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Automatically update your signature when switching between Exchange accounts
 description: Learn how to automatically update your signature when switching between Exchange accounts through the OnMessageFromChanged and OnAppointmentFromChanged events in your event-based activation Outlook add-in.
-ms.date: 07/22/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -60,6 +60,8 @@ Complete the [Outlook quick start](../quickstarts/outlook-quickstart-yo.md), whi
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-platforms](../includes/outlook-unified-manifest-platforms.md)]
+
 1. Open the **manifest.json** file.
 
 1. Navigate to the [`"authorization.permissions.resourceSpecific"`](/microsoft-365/extensibility/schema/root-authorization-permissions-resource-specific) array. In the array object, replace the value of the [`"name"`](/microsoft-365/extensibility/schema/root-authorization-permissions-resource-specific#name) property with `"MailboxItem.ReadWrite.User"`. This is needed by the add-in to be able to update the signature of a message.
diff --git 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: 07/01/2025
+ms.date: 08/01/2025
 ms.localizationpriority: medium
 ---
 
@@ -75,9 +75,10 @@ Here are examples of scenarios that make sense in Outlook mobile.
 
 ## 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.
+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/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). 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.
+> [!NOTE]
+> 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/pinnable-taskpane.md b/docs/outlook/pinnable-taskpane.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Implement a pinnable task pane in an Outlook add-in
 description: The task pane UX shape for add-in commands opens a vertical task pane to the right of an open message or meeting request, allowing the add-in to provide UI for more detailed interactions.
-ms.date: 07/15/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -36,6 +36,8 @@ The first step is to add pinning support, which is done in the add-in manifest.
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-mac](../includes/outlook-unified-manifest-mac.md)]
+
 Add a `"pinnable"` property, set to `true`, to the object in the [`"actions"`](/microsoft-365/extensibility/schema/extension-runtimes-actions-item) array that defines the button or menu item that opens the task pane. The following is an example.
 
 ```json
diff --git a/docs/outlook/sensitivity-label.md b/docs/outlook/sensitivity-label.md
@@ -1,7 +1,7 @@
 ---
 title: Manage the sensitivity label of your message or appointment in compose mode
 description: Learn how to manage the sensitivity label of your message or appointment in compose mode.
-ms.date: 07/17/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -42,6 +42,8 @@ To use the sensitivity feature in your Outlook add-in project, you must configur
 - **Unified manifest for Microsoft 365**: In the [`"authorization.permissions.resourceSpecific"`](/microsoft-365/extensibility/schema/root-authorization-permissions#resourcespecific) array, set the `"name"` property of an object to `"MailboxItem.ReadWrite.User"`.
 - **Add-in only manifest**: Set the [\<Permissions\> element](/javascript/api/manifest/permissions) to **ReadWriteItem**.
 
+[!INCLUDE [outlook-unified-manifest-mac](../includes/outlook-unified-manifest-mac.md)]
+
 If your add-in will detect and handle the `OnSensitivityLabelChanged` event, additional manifest configurations are required to enable the event-based activation feature. To learn more, see [Detect sensitivity label changes with the OnSensitivityLabelChanged event](#detect-sensitivity-label-changes-with-the-onsensitivitylabelchanged-event).
 
 [!INCLUDE [outlook-sensitivity-label-event-support](../includes/outlook-sensitivity-label-event-support.md)]
diff --git a/docs/outlook/smart-alerts-onmessagesend-walkthrough.md b/docs/outlook/smart-alerts-onmessagesend-walkthrough.md
@@ -1,7 +1,7 @@
 ﻿---
 title: Automatically check for an attachment before a message is sent
 description: Learn how to implement an event-based add-in that implements Smart Alerts to automatically check a message for an attachment before it's sent.
-ms.date: 06/18/2025
+ms.date: 08/01/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -27,6 +27,8 @@ To configure the manifest, select the tab for the type of manifest you are using
 
 # [Unified manifest for Microsoft 365](#tab/jsonmanifest)
 
+[!INCLUDE [outlook-unified-manifest-mac](../includes/outlook-unified-manifest-mac.md)]
+
 1. Open the **manifest.json** file.
 
 1. Add the following object to the [`"extensions.runtimes"`](/microsoft-365/extensibility/schema/extension-runtimes-array?view=m365-app-prev&preserve-view=true) array. Note the following about this markup:

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+> [!NOTE]`
	`2`	+> Add-ins that use the unified manifest for Microsoft 365 aren't directly supported in Outlook on Mac. To run this type of add-in on Mac, the add-in must first be published to [AppSource](https://appsource.microsoft.com/) then deployed in the [Microsoft 365 Admin Center](../publish/publish.md). For more information, see [Support for add-ins with the unified manifest for Microsoft 365](../outlook/compare-outlook-add-in-support-in-outlook-for-mac.md#support-for-add-ins-with-the-unified-manifest-for-microsoft-365).