diff --git a/docs/includes/outlook-manual-sideloading.md b/docs/includes/outlook-manual-sideloading.md index bf2f80013..ae6c36c0c 100644 --- a/docs/includes/outlook-manual-sideloading.md +++ b/docs/includes/outlook-manual-sideloading.md @@ -2,4 +2,4 @@ > > - When you first use Yeoman generator to develop an Office Add-in, your default browser opens a window where you'll be prompted to sign in to your Microsoft 365 account. If a sign-in window doesn't appear and you encounter a sideloading or login timeout error, run `atk auth login m365` before running `npm start` again. > -> If your add-in wasn't automatically sideloaded, follow the instructions in [Sideload Outlook add-ins for testing](../outlook/sideload-outlook-add-ins-for-testing.md#sideload-manually) to manually sideload the add-in in Outlook. +> - If your add-in wasn't automatically sideloaded, follow the instructions in [Sideload Outlook add-ins for testing](../outlook/sideload-outlook-add-ins-for-testing.md#sideload-manually) to manually sideload the add-in in Outlook. diff --git a/docs/outlook/smart-alerts-onmessagesend-walkthrough.md b/docs/outlook/smart-alerts-onmessagesend-walkthrough.md index 9fccd8c63..caece1497 100644 --- 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: 11/20/2025 +ms.date: 01/13/2026 ms.topic: how-to ms.localizationpriority: medium --- @@ -333,7 +333,8 @@ In this scenario, you'll add handling for sending a message. Your add-in will ch > [!NOTE] > -> Support to customize a button in the Smart Alerts dialog and program it to open a task pane was introduced in [requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). The ability to program a button to run a function was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> - Support to customize a button in the Smart Alerts dialog and program it to open a task pane was introduced in [requirement set 1.14](/javascript/api/requirement-sets/outlook/requirement-set-1.14/outlook-requirement-set-1.14). The ability to program a button to run a function was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> - The ability to program a dialog button to run a function is available to preview in Outlook on Mac starting in Version 16.105 (Build 25121117). To test this feature, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756) and select the **Beta Channel** option to access Office beta builds. If a mail item doesn't meet the conditions of a Smart Alerts add-in, a dialog is shown to the user to alert them that additional actions may be needed before an item can be sent. To provide the user with further guidance on how to meet the conditions of your add-in, you can customize the text of a button in the dialog and program it to open a task pane or run a function. @@ -342,10 +343,15 @@ The button you can customize depends on the Outlook client and version on which | Client | Customizable dialog button | Specifications | | --- | --- | --- | | **Windows (classic)**
[Supported Mailbox 1.14 versions](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#version-support-for-requirement-sets-in-classic-outlook-on-windows) prior to Version 2412 (Build 18324.20000)

**Mac**
Version 16.100 (25072537) | **Don't Send** | The text and functionality of the **Don't Send** button can be customized. Customizable functionality includes opening a task pane or running a function.

The **Don't Send** button appears in the dialog no matter what send mode option you select. By default, selecting **Don't Send** cancels the send operation and closes the dialog.

:::image type="content" source="../images/outlook-smart-alerts-dont-send.png" alt-text="Smart Alerts dialog with the Don't Send button."::: | -| **Web browser**

**Windows (new)**

**Windows (classic)**
Version 2412 (Build 18324.20000) or later | **Take Action** | The text and functionality of the **Take Action** button can be customized. Customizable functionality includes opening a task pane or running a function.

The **Take Action** button only appears in the Smart Alerts dialog when you configure a task pane or function to run from the dialog. When the **Take Action** button is present, the **Don't Send** button is used to cancel the mail item being sent. The text and functionality of the **Don't Send** button can't be customized.

:::image type="content" source="../images/outlook-smart-alerts-take-action.png" alt-text="Smart Alerts dialog with the Take Action button."::: | +| **Web browser**

**Windows (new)**

**Windows (classic)**
Version 2412 (Build 18324.20000) or later

**Mac**
in preview starting in Version 16.105 (Build 25121117) | **Take Action** | The text and functionality of the **Take Action** button can be customized. Customizable functionality includes opening a task pane or running a function.

The **Take Action** button only appears in the Smart Alerts dialog when you configure a task pane or function to run from the dialog. When the **Take Action** button is present, the **Don't Send** button is used to cancel the mail item being sent. The text and functionality of the **Don't Send** button can't be customized.

:::image type="content" source="../images/outlook-smart-alerts-take-action.png" alt-text="Smart Alerts dialog with the Take Action button."::: | > [!NOTE] -> In classic Outlook on Windows, if you customized the text and functionality of the **Don't Send** button in your Smart Alerts add-in prior to Version 2412 (Build 18324.20000), no additional action is needed to implement the **Take Action** button in the latest supported versions. The default or customized **Take Action** button will automatically appear the next time a user receives a Smart Alerts dialog. Although no implementation changes are needed, we recommend notifying users of this updated experience. +> If you've already customized the text and functionality of the **Don't Send** button in your Smart Alerts add-in for the following Outlook clients and versions, no additional action is needed to implement the **Take Action** button in the latest supported versions. +> +> - Classic Outlook on Windows prior to Version 2412 (Build 18324.20000) +> - Outlook on Mac prior to Version 16.105 (Build 25121117) +> +> The default or customized **Take Action** button will automatically appear the next time a user receives a Smart Alerts dialog. Although no implementation changes are needed, we recommend notifying users of this updated experience. > > If you only customized the text of the **Don't Send** button in earlier supported versions, your custom text won't appear in the latest versions that support the **Take Action** implementation. @@ -464,9 +470,9 @@ To override the send mode option at runtime, you must set the [sendModeOverride] If you implemented the optional steps to customize a dialog button or override the send mode option in this walkthrough, you also need to configure the task pane. > [!NOTE] -> In Outlook on the web, new Outlook on Windows, supported versions of classic Outlook on Windows prior to Version 2412 (Build 18324.20000), and Outlook on Mac, you can customize the text of the **Don't Send** button without implementing a task pane or function command. Although the task pane is needed in this sample, it isn't a requirement to be able to customize the button text or override the send mode option in these clients. +> In Outlook on the web, new Outlook on Windows, supported versions of classic Outlook on Windows prior to Version 2412 (Build 18324.20000), and supported versions of Outlook on Mac prior to Version 16.105 (Build 25121117), you can customize the text of the **Don't Send** button without implementing a task pane or function command. Although the task pane is needed in this sample, it isn't a requirement to be able to customize the button text or override the send mode option in these clients. > -> In classic Outlook on Windows starting in Version 2412 (Build 18324.20000), you must implement a task pane or function command to customize the **Take Action** button. This is because the **Take Action** button only appears in the Smart Alerts dialog when a task pane or function command is implemented in the add-in. +> In classic Outlook on Windows starting in Version 2412 (Build 18324.20000) and in Outlook on Mac starting in Version 16.105 (Build 25121117), you must implement a task pane or function command to customize the **Take Action** button. This is because the **Take Action** button only appears in the Smart Alerts dialog when a task pane or function command is implemented in the add-in. 1. Navigate to the **./src/taskpane** folder, then open **taskpane.html**. 1. Select the entire `` node (including its open and close tags) and replace it with the following code. @@ -583,7 +589,9 @@ If you implemented the optional steps to customize a dialog button or override t ### Programmatically send the item from the task pane (optional) > [!NOTE] -> The `sendAsync` method was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its supported clients and platforms. +> +> - The `sendAsync` method was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its supported clients and platforms. +> - The `sendAsync` method is available for preview in Outlook on Mac starting in Version 16.105 (Build 25121117). To test the method, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756) and select the **Beta Channel** option to access Office beta builds. To further streamline a user's experience when recommending changes to the mail items they're sending, call the [sendAsync](/javascript/api/requirement-sets/outlook/requirement-set-1.15/office.context.mailbox.item?view=outlook-js-1.15&preserve-view=true#methods) method in your task pane or function command code. @@ -684,11 +692,11 @@ To further streamline a user's experience when recommending changes to the mail :::image type="content" source="../images/outlook-win-smart-alerts-take-action.png" alt-text="Dialog with a Take Action button that opens a task pane."::: - - Customized **Add an attachment** button. Applies to Outlook on the web, new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). + - Customized **Add an attachment** button. Applies to Outlook on the web, on Mac (in preview starting in Version 16.105 (Build 25121117)), new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). :::image type="content" source="../images/outlook-smart-alerts-custom-take-action.png" alt-text="Dialog with a customized Take Action button requesting the user to add an attachment to the message."::: - - Customized **Add an attachment** button. Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000). + - Customized **Add an attachment** button. Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000) and Outlook on Mac prior to Version 16.105 (Build 25121117). :::image type="content" source="../images/outlook-smart-alerts-custom-button.png" alt-text="Dialog with a customized Don't Send button requesting the user to add an attachment to the message."::: @@ -717,11 +725,11 @@ If you implemented the optional step to override the send mode option at runtime 1. Send the message. A dialog appears recommending to attach a copy of the image to the message. 1. Select **Send Anyway** to send the message as is, or select **Attach a copy** to include a copy before sending the message. - - Applies to Outlook on the web, new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). + - Applies to Outlook on the web, on Mac (in preview starting in Version 16.105 (Build 25121117)), new Outlook on Windows, and classic Outlook on Windows (starting in Version 2412 (Build 18324.20000)). :::image type="content" source="../images/outlook-smart-alerts-custom-button-and-override.png" alt-text="Customized Smart Alerts dialog with the Send Anyway option available at runtime."::: - - Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000). + - Applies to classic Outlook on Windows prior to Version 2412 (Build 18324.20000) and Outlook on Mac prior to Version 16.105 (Build 25121117). :::image type="content" source="../images/outlook-smart-alerts-send-mode-override.png" alt-text="Smart Alerts dialog with the Send Anyway option available at runtime in classic Outlook on Windows prior to Version 2412 (Build 18324.20000)."::: diff --git a/docs/outlook/spam-reporting.md b/docs/outlook/spam-reporting.md index e0c70bf19..a0dc02ad0 100644 --- a/docs/outlook/spam-reporting.md +++ b/docs/outlook/spam-reporting.md @@ -1,7 +1,7 @@ --- title: Implement an integrated spam-reporting add-in description: Learn how to implement an integrated spam-reporting add-in in Outlook. -ms.date: 08/26/2025 +ms.date: 01/13/2026 ms.topic: how-to ms.localizationpriority: medium --- @@ -55,6 +55,9 @@ To implement the integrated spam-reporting feature in your add-in, you must conf :::image type="content" source="../images/outlook-spam-processing-dialog.png" alt-text="A sample preprocessing dialog of a spam-reporting add-in."::: + > [!NOTE] + > Using radio buttons as an input option is available for preview in Outlook on Mac starting in Version 16.103 (Build 25101816). To test this feature, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756) and select the **Beta Channel** option to access Office beta builds. + Select the tab for the type of manifest you're using. # [Unified manifest for Microsoft 365](#tab/jsonmanifest) @@ -464,7 +467,9 @@ The following is a sample post-processing dialog shown to the user once the add- ## Suppress the preprocessing dialog > [!NOTE] -> The "Don't show me this message again" option was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> +> - The "Don't show me this message again" option was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> - The "Don't show me this message again" option is available for preview in Outlook on Mac starting in Version 16.103 (Build 25101816). To test this feature, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756) and select the **Beta Channel** option to access Office beta builds. Depending on your scenario, you might not need a user to provide additional information about a message they're reporting. If the preprocessing dialog of your spam-reporting add-in only provides information to the user, you can choose to include a "Don't show me this message again" option in the dialog. @@ -524,7 +529,9 @@ Note the following behaviors when implementing this option in your add-in. ### Reenable the preprocessing dialog -To reenable the preprocessing dialog in classic Outlook on Windows after selecting the "Don't show me this message again" option, perform the following steps. +The steps to reenable the preprocessing dialog after selecting the "Don't show me this message again" option vary depending on your Outlook client. + +#### Classic Outlook on Windows 1. Open the **Registry Editor** as an administrator. 1. Navigate to **HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\Options\WebExt\SpamDialog**. @@ -533,10 +540,23 @@ To reenable the preprocessing dialog in classic Outlook on Windows after selecti The preprocessing dialog will appear the next time a message is reported. +#### Outlook on Mac + +1. Close the Outlook client. +1. In a terminal window, run the following command. + + ```command line + defaults delete com.microsoft.Outlook IntegratedSpamNeverShowAgainPreference + ``` + +The preprocessing dialog will appear the next time a message is reported. + ## Open a task pane after reporting a message > [!NOTE] -> The option to implement a task pane from the `event.completed` method was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> +> - The option to implement opening a task pane from the `event.completed` method was introduced in [requirement set 1.15](/javascript/api/requirement-sets/outlook/requirement-set-1.15/outlook-requirement-set-1.15). Learn more about its [supported clients and platforms](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#outlook-client-support). +> - This feature is available for preview in Outlook on Mac starting in Version 16.103 (Build 25101816). To test this feature, join the [Microsoft 365 Insider program](https://techcommunity.microsoft.com/kb/microsoft-365-insider-kb/join-the-microsoft-365-insider-program-on-macos/4401756) and select the **Beta Channel** option to access Office beta builds. Instead of a post-processing dialog, you can implement a task pane to open after a user reports a message. For example, you can use the task pane to show additional information based on the user's input in the preprocessing dialog. Similar to the post-processing dialog, the task pane is implemented through the add-in's `event.completed` call.