diff --git a/docs/develop/event-based-activation.md b/docs/develop/event-based-activation.md index a853a5486..3e7a25c34 100644 --- a/docs/develop/event-based-activation.md +++ b/docs/develop/event-based-activation.md @@ -1,7 +1,7 @@ --- title: Activate add-ins with events description: Learn how to develop an Office Add-in that implements event-based activation. -ms.date: 11/27/2025 +ms.date: 12/16/2025 ms.topic: concept-article ms.localizationpriority: medium --- @@ -67,11 +67,11 @@ Support for this feature in Outlook was introduced in [requirement set 1.10](/ja |`OnAppointmentSend`|appointmentSending|On sending an appointment item. To learn more, see [Handle OnMessageSend and OnAppointmentSend events in your Outlook add-in with Smart Alerts](../outlook/onmessagesend-onappointmentsend-events.md).|[1.12](/javascript/api/requirement-sets/outlook/requirement-set-1.12/outlook-requirement-set-1.12)| |`OnMessageCompose`|messageComposeOpened|On composing a new message (includes reply, reply all, and forward) or editing a draft.|[1.12](/javascript/api/requirement-sets/outlook/requirement-set-1.12/outlook-requirement-set-1.12)| |`OnAppointmentOrganizer`|appointmentOrganizerOpened|On creating a new appointment or editing an existing one.|[1.12](/javascript/api/requirement-sets/outlook/requirement-set-1.12/outlook-requirement-set-1.12)| -|`OnMessageFromChanged`|messageFromChanged|On changing the mail account in the **From** field of a message being composed. To learn more, see [Automatically update your signature when switching between Exchange accounts](../outlook/onmessagefromchanged-onappointmentfromchanged-events.md).|[1.13](/javascript/api/requirement-sets/outlook/requirement-set-1.13/outlook-requirement-set-1.13)| +|`OnMessageFromChanged`|messageFromChanged|On changing the mail account in the **From** field of a message being composed. To learn more, see [Automatically update your signature when switching between Exchange accounts](../outlook/onmessagefromchanged-onappointmentfromchanged-events.md).|[1.13](/javascript/api/requirement-sets/outlook/requirement-set-1.13/outlook-requirement-set-1.13)| |`OnAppointmentFromChanged`|appointmentFromChanged|On changing the mail account in the organizer field of an appointment being composed. To learn more, see [Automatically update your signature when switching between Exchange accounts](../outlook/onmessagefromchanged-onappointmentfromchanged-events.md).|[1.13](/javascript/api/requirement-sets/outlook/requirement-set-1.13/outlook-requirement-set-1.13)| -|`OnSensitivityLabelChanged`|sensitivityLabelChanged|On changing the sensitivity label while composing a message or appointment. To learn how to manage the sensitivity label of a mail item, see [Manage the sensitivity label of your message or appointment in compose mode](../outlook/sensitivity-label.md).

Event-specific data object: [SensitivityLabelChangedEventArgs](/javascript/api/outlook/office.sensitivitylabelchangedeventargs?view=outlook-js-preview&preserve-view=true)|[1.13](/javascript/api/requirement-sets/outlook/requirement-set-1.13/outlook-requirement-set-1.13)| -|`OnMessageReadWithCustomAttachment`|Not available|On opening a message that contains a specific attachment type in read mode.|[Preview](/javascript/api/requirement-sets/outlook/preview-requirement-set/outlook-requirement-set-preview)5| -|`OnMessageReadWithCustomHeader`|Not available|On opening a message that contains a specific internet header name in read mode.|[Preview](/javascript/api/requirement-sets/outlook/preview-requirement-set/outlook-requirement-set-preview)5| +|`OnSensitivityLabelChanged`|sensitivityLabelChanged|On changing the sensitivity label while composing a message or appointment. To learn how to manage the sensitivity label of a mail item, see [Manage the sensitivity label of your message or appointment in compose mode](../outlook/sensitivity-label.md).

Event-specific data object: [SensitivityLabelChangedEventArgs](/javascript/api/outlook/office.sensitivitylabelchangedeventargs?view=outlook-js-preview&preserve-view=true)|[1.13](/javascript/api/requirement-sets/outlook/requirement-set-1.13/outlook-requirement-set-1.13)| +|`OnMessageReadWithCustomAttachment`|Not available|On opening a message that contains a specific attachment type in read mode.|[Preview](/javascript/api/requirement-sets/outlook/preview-requirement-set/outlook-requirement-set-preview)4| +|`OnMessageReadWithCustomHeader`|Not available|On opening a message that contains a specific internet header name in read mode.|[Preview](/javascript/api/requirement-sets/outlook/preview-requirement-set/outlook-requirement-set-preview)4| |`OnMessageRead` (preview)|Not available|On matching the header of an encrypted message to the header key in an add-in's manifest. To learn more, see [Create an encryption Outlook add-in](../outlook/encryption-decryption.md).|[Preview](/javascript/api/requirement-sets/outlook/preview-requirement-set/outlook-requirement-set-preview)| > [!NOTE] @@ -81,9 +81,7 @@ Support for this feature in Outlook was introduced in [requirement set 1.10](/ja > > 3 For more information, see [Implement event-based activation in Outlook mobile add-ins](../outlook/mobile-event-based.md). > -> 4 The `OnMessageFromChanged` and `OnSensitivityLabelChanged` events aren't currently available with the unified manifest for Microsoft 365 in Outlook on the web and the new Outlook on Windows. To handle these events, implement an add-in only manifest instead. For information about the types of manifests, see [Office Add-ins manifest](add-in-manifests.md). -> -> 5 To preview the `OnMessageReadWithCustomAttachment` and `OnMessageReadWithCustomHeader` events, you must install classic Outlook on Windows Version 2312 (Build 17110.10000) or later. Then, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/blog/microsoft365insiderblog/join-the-microsoft-365-insider-program-on-windows/4206638) and select the **Beta Channel** option to access Office beta builds. +> 4 To preview the `OnMessageReadWithCustomAttachment` and `OnMessageReadWithCustomHeader` events, you must install classic Outlook on Windows Version 2312 (Build 17110.10000) or later. Then, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/blog/microsoft365insiderblog/join-the-microsoft-365-insider-program-on-windows/4206638) and select the **Beta Channel** option to access Office beta builds. #### Event-based activation in Outlook on mobile devices diff --git a/docs/includes/outlook-sensitivity-label-event-support.md b/docs/includes/outlook-sensitivity-label-event-support.md deleted file mode 100644 index 81aabd4c1..000000000 --- a/docs/includes/outlook-sensitivity-label-event-support.md +++ /dev/null @@ -1,2 +0,0 @@ -> [!NOTE] -> The `OnSensitivityLabelChanged` event isn't currently available with the unified manifest for Microsoft 365 in Outlook on the web and the new Outlook on Windows. To handle these events, implement an add-in only manifest instead. For information about the types of manifests, see [Office Add-ins manifest](../develop/add-in-manifests.md). diff --git a/docs/outlook/onmessagefromchanged-onappointmentfromchanged-events.md b/docs/outlook/onmessagefromchanged-onappointmentfromchanged-events.md index a9bfb5fbd..f9558b830 100644 --- 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: 11/18/2025 +ms.date: 12/16/2025 ms.topic: how-to ms.localizationpriority: medium --- @@ -55,9 +55,6 @@ Complete the [Outlook quick start](../quickstarts/outlook-quickstart-yo.md), whi ## Configure the manifest -> [!NOTE] -> The `OnMessageFromChanged` event isn't currently available with the unified manifest for Microsoft 365 in Outlook on the web and the new Outlook on Windows. To handle these events, implement an add-in only manifest instead. For information about the types of manifests, see [Office Add-ins manifest](../develop/add-in-manifests.md). - # [Unified manifest for Microsoft 365](#tab/jsonmanifest) [!INCLUDE [outlook-unified-manifest-platforms](../includes/outlook-unified-manifest-platforms.md)] diff --git a/docs/outlook/sensitivity-label.md b/docs/outlook/sensitivity-label.md index 23eb6a895..7fb107530 100644 --- 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: 08/01/2025 +ms.date: 12/16/2025 ms.topic: how-to ms.localizationpriority: medium --- @@ -46,8 +46,6 @@ To use the sensitivity feature in your Outlook add-in project, you must configur 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)] - ## Verify the status of the catalog of sensitivity labels Sensitivity labels and policies are configured by an organization's administrator through the [Microsoft Purview compliance portal](/microsoft-365/compliance/microsoft-365-compliance-center). For guidance on how to configure sensitivity labels in your tenant, see [Create and configure sensitivity labels and their policies](/microsoft-365/compliance/create-sensitivity-labels). @@ -203,8 +201,6 @@ Take extra measures to protect your data by using the `OnSensitivityLabelChanged The `OnSensitivityLabelChanged` event is available through the event-based activation feature. To learn how to configure, debug, and deploy an event-based add-in that uses this event, see [Activate add-ins with events](../develop/event-based-activation.md). -[!INCLUDE [outlook-sensitivity-label-event-support](../includes/outlook-sensitivity-label-event-support.md)] - ## See also - [Learn about sensitivity labels](/microsoft-365/compliance/sensitivity-labels)