Skip to content

Commit 24b0c87

Browse files
[Outlook] (Smart Alerts) Update item-switch behavior in Outlook on the web and new Outlook on Windows (#5214)
* Update item-switch behavior for Outlook on the web and new Outlook * Fix tab * Change headings * Fix images Co-authored-by: Elizabeth Samuel <elizs@microsoft.com> * Fix images --------- Co-authored-by: Elizabeth Samuel <elizs@microsoft.com>
1 parent 0b4329a commit 24b0c87

8 files changed

+25
-12
lines changed
-5.16 KB
Binary file not shown.
-5.45 KB
Binary file not shown.
5.35 KB
Loading
Loading
13.6 KB
Loading
Loading
Binary file not shown.

docs/outlook/onmessagesend-onappointmentsend-events.md

Lines changed: 25 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Handle OnMessageSend and OnAppointmentSend events in your Outlook add-in with Smart Alerts
33
description: Learn about the Smart Alerts implementation and how it handles the OnMessageSend and OnAppointmentSend events in your event-based Outlook add-in.
4-
ms.date: 06/05/2025
4+
ms.date: 06/10/2025
55
ms.topic: concept-article
66
ms.localizationpriority: medium
77
---
@@ -225,33 +225,46 @@ If the Smart Alerts add-in implements the **prompt user** option, it doesn't pro
225225

226226
When a user navigates away from the message they're sending (for example, to read a message in their inbox), the behavior of a Smart Alerts add-in differs between Outlook clients. Select the tab for the Outlook client on which the add-in is running.
227227

228-
# [Web/Windows (new)](#tab/web-new-windows)
229-
230-
In Outlook on the web or in [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627), a user must remain on the message being sent until the Smart Alerts add-in completes processing it. Otherwise, once the user navigates away from the item, the add-in terminates the Smart Alerts operation and saves a draft to the mailbox's **Drafts** folder. The user is then alerted that they must resend the message from the **Drafts** folder and remain on the message until the add-in completes processing it.
231-
232-
:::image type="content" source="../images/outlook-smart-alerts-item-switch-dialog-web.png" alt-text="The dialog shown to the user in Outlook on the web or new Outlook on Windows when they navigate away from a message after selecting Send.":::
233-
234-
# [Windows (classic)](#tab/windows)
228+
# [Web / Windows](#tab/web-new-windows+windows)
235229

236230
#### Message composed in a window
237231

238-
Starting in Version 2402 (Build 17310.10000), if a message is being composed in a separate window, such as a new message, and a user navigates away from it after they select **Send**, the Smart Alerts add-in will continue to process the message in the background. If additional actions are needed before the message can be sent, the appropriate Smart Alerts dialog is shown to the user (see [Available send mode options](#available-send-mode-options)).
232+
> [!NOTE]
233+
> In classic Outlook on Windows, the behavior described in this section applies to Version 2402 (Build 17310.10000) and later.
234+
235+
If a message is being composed in a separate window, such as a new message, and a user navigates away from it after they select **Send**, the Smart Alerts add-in will continue to process the message in the background. If additional actions are needed before the message can be sent, the appropriate Smart Alerts dialog is shown to the user (see [Available send mode options](#available-send-mode-options)).
239236

240237
#### Message composed in the Reading Pane
241238

242-
Starting in Version 2402 (Build 17310.10000), if a reply, forward, or existing draft is being composed in the Outlook Reading Pane, and a user navigates away from it after they select **Send**, a dialog with options is shown to the user. The options available depend on the [send mode option](#available-send-mode-options) implemented by the add-in.
239+
If a reply, forward, or existing draft is being composed in the Outlook Reading Pane, and a user navigates away from it after they select **Send**, a dialog with options is shown to the user. The options available depend on the [send mode option](#available-send-mode-options) implemented by the add-in.
243240

244241
If the [prompt user](#prompt-user) send mode option is implemented, the following options are shown.
245242

246243
- **Wait**: This option opens the message being composed in a new window, so that the Smart Alerts add-in can continue to process it. If the user navigates away from the newly opened window during processing, the add-in will continue to process the message in the background (to learn more, see [Message composed in a window](#message-composed-in-a-window)). If additional actions are needed before a message can be sent, the appropriate Smart Alerts dialog is shown to the user.
247244
- **Send Anyway**: This option terminates the add-in operation and sends the message.
245+
246+
> [!IMPORTANT]
247+
> In Outlook on the web and new Outlook on Windows, the **Send Anyway** option may not appear in the item-switch dialog even if the add-in currently running implements the **prompt user** send mode option. This is because the **Send Anyway** option is shown only if all installed Smart Alerts add-ins implement the **prompt user** send mode option. Otherwise, only the **Wait** and **Save as Draft** options are shown. This helps provide a more secure experience since multiple Smart Alerts add-ins can launch in any order (for more information on this behavior, see [Event-based activation behavior and limitations](autolaunch.md#event-based-activation-behavior-and-limitations)).
248+
248249
- **Save as Draft**: This option terminates the add-in and send operations and saves a draft of the message to the mailbox's **Drafts** folder.
249250

250-
:::image type="content" source="../images/outlook-item-switch-prompt-user.png" alt-text="The dialog shown when a user navigates away from a message being processed by a Smart Alerts add-in that implements the prompt user send mode option.":::
251+
**Outlook on the web and new Outlook on Windows**
252+
253+
:::image type="content" source="../images/outlook-item-switch-web-prompt-user.png" alt-text="The dialog shown in Outlook on the web and new Outlook on Windows when a user navigates away from a message being processed by a Smart Alerts add-in that implements the prompt user send mode option.":::
254+
255+
**Classic Outlook on Windows**
256+
257+
:::image type="content" source="../images/outlook-item-switch-win32-prompt-user.png" alt-text="The dialog shown in classic Outlook on Windows when a user navigates away from a message being processed by a Smart Alerts add-in that implements the prompt user send mode option.":::
251258

252259
If the [soft block](#soft-block) or [block](#block) send mode option is implemented, only the **Wait** and **Save as Draft** options are shown.
253260

254-
:::image type="content" source="../images/outlook-item-switch-block.png" alt-text="The dialog shown when a user navigates away from a message being processed by a Smart Alerts add-in that implements the soft block or block send mode option.":::
261+
**Outlook on the web and new Outlook on Windows**
262+
263+
:::image type="content" source="../images/outlook-item-switch-web-block.png" alt-text="The dialog shown in Outlook on the web and new Outlook on Windows when a user navigates away from a message being processed by a Smart Alerts add-in that implements the soft block or block send mode option.":::
264+
265+
**Classic Outlook on Windows**
266+
267+
:::image type="content" source="../images/outlook-item-switch-win32-block.png" alt-text="The dialog shown in classic Outlook on Windows when a user navigates away from a message being processed by a Smart Alerts add-in that implements the soft block or block send mode option.":::
255268

256269
# [Mac](#tab/mac)
257270

0 commit comments

Comments
 (0)