Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
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
6 changes: 4 additions & 2 deletions docs/manifest/launchevent.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: LaunchEvent in the manifest file
description: The LaunchEvent element configures your add-in to activate based on supported events.
ms.date: 07/02/2025
ms.date: 10/09/2025
ms.localizationpriority: medium
---

Expand All @@ -25,6 +25,7 @@ For more information, see [Version overrides in the add-in only manifest](/offic
<LaunchEvents>
<LaunchEvent Type="OnNewMessageCompose" FunctionName="onMessageComposeHandler"/>
<LaunchEvent Type="OnNewAppointmentOrganizer" FunctionName="onAppointmentComposeHandler"/>
<LaunchEvent Type="OnMessageRead" FunctionName="onMessageReadHandler" HeaderName="contoso-encrypted"/>
<LaunchEvent Type="OnMessageReadWithCustomHeader" FunctionName="onMessageReadWithCustomHeaderHandler" HeaderName="contoso-spam-simulation"/>
<LaunchEvent Type="OnMessageReadWithCustomAttachment" FunctionName="onMessageReadWithCustomAttachmentHandler">
<MessageAttachments>
Expand All @@ -49,7 +50,7 @@ For more information, see [Version overrides in the add-in only manifest](/offic
| **Type** | Yes | Specifies a supported event type. For the set of supported types, see the "Event canonical name and add-in only manifest name" column of the table of supported events in [Activate add-ins with events](/office/dev/add-ins/develop/event-based-activation#supported-events). |
| **FunctionName** | Yes | Specifies the name of the JavaScript function to handle the event specified in the `Type` attribute. |
| **SendMode** | No | Used by the `OnMessageSend` and `OnAppointmentSend` events. Specifies the options available to the user if your add-in stops an item from being sent or if the add-in is unavailable. If the **SendMode** property isn't included, the `SoftBlock` option is set by default. For a list of available send mode options, see [Available send mode options](/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough#available-send-mode-options). |
| **HeaderName** (preview) | No | Specifies the internet header name used to identify a message on which the `OnMessageReadWithCustomHeader` event occurs. The `Type` attribute must be set to `OnMessageReadWithCustomHeader`. |
| **HeaderName** (preview) | No | Specifies the internet header name used to identify a message on which the `OnMessageRead` or `OnMessageReadWithCustomHeader` event occurs. The `Type` attribute must be set to `OnMessageRead` or `OnMessageReadWithCustomHeader`. |

## Child elements

Expand All @@ -65,3 +66,4 @@ For more information, see [Version overrides in the add-in only manifest](/offic
- [Automatically check for an attachment before a message is sent](/office/dev/add-ins/outlook/smart-alerts-onmessagesend-walkthrough)
- [Automatically update your signature when switching between Exchange accounts](/office/dev/add-ins/outlook/onmessagefromchanged-onappointmentfromchanged-events)
- [Implement event-based activation in Outlook mobile add-ins](/office/dev/add-ins/outlook/mobile-event-based)
- [Create an encryption Outlook add-in](/office/dev/add-ins/outlook/encryption-decryption)
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Outlook add-in API preview requirement set
description: Features and APIs that are currently in preview for Outlook add-ins.
ms.date: 03/11/2025
ms.date: 10/09/2025
ms.topic: whats-new
ms.localizationpriority: medium
---
Expand Down Expand Up @@ -75,6 +75,50 @@ Added a new property that represents if an appointment is an all-day event.

---

### Decrypt a message and its attachments

#### [OnMessageRead event](/office/dev/add-ins/develop/event-based-activation#outlook-events)

Added a decryption event that occurs when the header of an encrypted message matches the header key of an installed encryption add-in.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

#### [HeaderName attribute in the LaunchEvent element](../../../manifest/launchevent.md#attributes)

Updated the `HeaderName` attribute of the **\<LaunchEvent\>** XML element to specify the header key used for decryption.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

#### [Event.completed method](/javascript/api/outlook/office.mailboxevent?view=outlook-js-preview&preserve-view=true#outlook-office-mailboxevent-completed-member(1))

Updated the `event.completed` method to indicate when an encryption add-in has completed processing the `OnMessageRead` event.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

#### [Office.MessageDecryptEventCompletedOptions](/javascript/api/outlook/office.messagedecrypteventcompletedoptions?view=outlook-js-preview&preserve-view=true)

Added an object to specify the behavior of an encryption add-in after it completes processing an `OnMessageRead` event.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

#### [Office.DecryptedMessageAttachment](/javascript/api/outlook/office.decryptedmessageattachment?view=outlook-js-preview&preserve-view=true)

Added an object that represents an attachment in a decrypted message.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

#### [Office.DecryptedMessageBody](/javascript/api/outlook/office.decryptedmessagebody?view=outlook-js-preview&preserve-view=true)

Added an object that represents the body of a decrypted message.

**Available in**: Classic Outlook on Windows (Microsoft 365 subscription)

<br>

---

---

### Temporarily set the body or subject displayed in read mode

#### [Office.context.mailbox.item.display](/javascript/api/outlook/office.messageread?view=outlook-js-preview&preserve-view=true#outlook-office-messageread-display-member)
Expand Down