Skip to content

Commit efad719

Browse files
[Outlook] (multi-select) Update pinning behavior of task pane (#5455)
* Update pinning behavior for multi-select add-ins * Update pinning behavior in other articles * Apply suggestion from review * Create an include file
1 parent 90bfe58 commit efad719

File tree

3 files changed

+7
-8
lines changed

3 files changed

+7
-8
lines changed
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
When you select multiple mail items and launch the multi-select add-in's task pane, the pinning behavior of the task pane varies depending on the Outlook client.
2+
- **Mac**: The task pane stays open even when a user switches to a different mail item. The task pane can only be closed by selecting the **Close** button from the task pane.
3+
- **Windows (new and classic) and web**: The task pane doesn't stay open when the user switches to a new item.

docs/outlook/item-multi-select.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Activate your Outlook add-in on multiple messages
33
description: Learn how to activate your Outlook add-in when multiple messages are selected.
4-
ms.date: 07/15/2025
4+
ms.date: 11/06/2025
55
ms.topic: how-to
66
ms.localizationpriority: medium
77
---
@@ -382,9 +382,7 @@ Item multi-select supports [Conversations view](https://support.microsoft.com/of
382382

383383
### Task pane pinning in multi-select add-ins
384384

385-
In Outlook on the web, on Mac, and in new Outlook on Windows, when the task pane of a multi-select add-in is opened, it's automatically pinned to the Outlook client. It remains pinned even when a user switches to a different mail item or selects the **pin** icon from the task pane. The task pane can only be closed by selecting the **Close** button from the task pane.
386-
387-
Conversely, in classic Outlook on Windows, the task pane isn't automatically pinned and closes when a user switches to a different mail item.
385+
[!INCLUDE [outlook-multi-select-pinning](../includes/outlook-multi-select-pinning.md)]
388386

389387
## Next steps
390388

docs/outlook/pinnable-taskpane.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Implement a pinnable task pane in an Outlook add-in
33
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.
4-
ms.date: 08/01/2025
4+
ms.date: 11/06/2025
55
ms.topic: how-to
66
ms.localizationpriority: medium
77
---
@@ -127,9 +127,7 @@ Office.onReady(() => {
127127
128128
## Task pane pinning in multi-select
129129

130-
In Outlook on the web, on Mac, and in the new Outlook on Windows, when the task pane of an add-in that implements the [item multi-select](item-multi-select.md) feature is opened, it's automatically pinned to the Outlook client. It remains pinned even when a user switches to a different mail item or selects the **pin** icon from the task pane. The task pane can only be closed by selecting the **Close** button from the task pane.
131-
132-
Conversely, in classic Outlook on Windows, the task pane of a multi-select add-in isn't automatically pinned and closes when a user switches to a different mail item.
130+
[!INCLUDE [outlook-multi-select-pinning](../includes/outlook-multi-select-pinning.md)]
133131

134132
## Deploy to users
135133

0 commit comments

Comments
 (0)