From fa4f420bbef968dee90bd068e6574d43f3cf6043 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Sat, 22 Mar 2025 15:35:25 -0700 Subject: [PATCH 01/10] Draft shared mailbox scenarios --- docs/outlook/delegate-access.md | 64 +++++++++++++++++++-------------- 1 file changed, 38 insertions(+), 26 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 1913d14d1..4cc3a3383 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -1,7 +1,7 @@ --- title: Implement shared folders and shared mailbox scenarios in an Outlook add-in description: Discusses how to configure Outlook add-in support for shared folders (also known as delegate access) and shared mailboxes. -ms.date: 02/25/2025 +ms.date: 03/27/2025 ms.topic: how-to ms.localizationpriority: medium --- @@ -19,20 +19,20 @@ The following table shows supported client-server combinations for this feature, | Client | Exchange Online | Exchange 2019 on-premises
(Cumulative Update 1 or later) | Exchange 2016 on-premises
(Cumulative Update 6 or later) | |---|---|---|---| -|**Web browser (modern Outlook UI)**|Supported1|Not applicable|Not applicable| +|**Web browser (modern Outlook UI)**|Supported|Not applicable|Not applicable| |**Web browser (classic Outlook UI)**|Not applicable||| |[new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)|Supported|Not applicable|Not applicable| -|**Windows (classic)**
**Shared folders**: Version 1910 (Build 12130.20272) or later

**Shared mailboxes**: Version 2304 (Build 16327.20248) or later|Supported|Supported2|Supported2| +|**Windows (classic)**
**Shared folders**: Version 1910 (Build 12130.20272) or later

**Shared mailboxes**: Version 2304 (Build 16327.20248) or later|Supported|Supported\*|Supported\*| |**Mac**
Version 16.47 or later|Supported|Supported|Supported| +|**Android**|Not applicable|Not applicable|Not applicable| +|**iOS**|Not applicable|Not applicable|Not applicable| > [!NOTE] -> 1In Outlook on the web, if you open a shared mailbox in a separate browser tab or window using the **Open another mailbox** option, you may encounter issues when accessing add-ins from the mailbox. We recommend opening the mailbox in the same panel as your primary mailbox instead. This ensures that add-ins work as expected in your shared mailbox. If you prefer to open the shared mailbox using the **Open another mailbox** option, we recommend deploying the add-in to both your primary user and shared mailboxes. -> -> 2Support for this feature in an on-premises Exchange environment is available starting in classic Outlook on Windows Version 2206 (Build 15330.20000) for the Current Channel and Version 2207 (Build 15427.20000) for the Monthly Enterprise Channel. +> \* Support for this feature in an on-premises Exchange environment is available starting in classic Outlook on Windows Version 2206 (Build 15330.20000) for the Current Channel and Version 2207 (Build 15427.20000) for the Monthly Enterprise Channel. ## Supported setups -The following sections describe supported configurations for shared mailboxes and shared folders. The feature APIs may not work as expected in other configurations. Select the platform you'd like to learn how to configure. +The following sections describe configurations for shared mailboxes and shared folders that support the use of add-ins. The feature APIs may not work as expected in other configurations. Select the platform you'd like to learn how to configure. ### [Web (modern) and new Outlook on Windows](#tab/web) @@ -58,11 +58,6 @@ A shared mailbox allows a group of users to easily monitor and send messages and In Outlook on the web, a shared mailbox can be opened in the same panel as a user's primary mailbox or in a separate browser tab or window. For guidance, see [Open and use a shared mailbox in Outlook on the web](https://support.microsoft.com/office/98b5a90d-4e38-415d-a030-f09a4cd28207). -> [!NOTE] -> In Outlook on the web, if you open a shared mailbox in a separate browser tab or window using the **Open another mailbox** option, you may encounter issues when accessing add-ins from the mailbox. We recommend opening the mailbox in the same panel as your primary mailbox instead. This ensures that add-ins work as expected in your shared mailbox. -> -> If you prefer to open the shared mailbox using the **Open another mailbox** option, we recommend deploying the add-in to both your primary user and shared mailboxes. - In new Outlook on Windows, a shared mailbox is added to the **Shared with me** section of the folder pane. For guidance, see [Open and use a shared mailbox in Outlook](https://support.microsoft.com/office/d94a8e9e-21f1-4240-808b-de9c9c088afd). ### [Windows (classic)](#tab/windows) @@ -83,36 +78,50 @@ Once access is provided, the delegate must then follow the instructions outlined Exchange server admins can create and manage shared mailboxes for sets of users to access. [Exchange Online](/exchange/collaboration-exo/shared-mailboxes) and [on-premises Exchange environments](/exchange/collaboration/shared-mailboxes/create-shared-mailboxes) are supported. -An Exchange Server feature known as "automapping" is on by default which means that subsequently the [shared mailbox should automatically appear](/microsoft-365/admin/email/create-a-shared-mailbox?view=o365-worldwide&preserve-view=true#add-the-shared-mailbox-to-outlook) in a user's Outlook app after Outlook has been closed and reopened. However, if an admin turned off automapping, the user must follow the manual steps outlined in the "Add a shared mailbox to Outlook" section of the article [Open and use a shared mailbox in Outlook](https://support.microsoft.com/office/d94a8e9e-21f1-4240-808b-de9c9c088afd). +An Exchange Server feature known as "automapping" is on by default. This means that subsequently the [shared mailbox should automatically appear](/microsoft-365/admin/email/create-a-shared-mailbox?view=o365-worldwide&preserve-view=true#add-the-shared-mailbox-to-outlook) in a user's Outlook client after Outlook has been closed and reopened. However, if an admin turned off automapping, the user must follow the manual steps outlined in the "Add a shared mailbox to Outlook" section of the article [Open and use a shared mailbox in Outlook](https://support.microsoft.com/office/d94a8e9e-21f1-4240-808b-de9c9c088afd). > [!WARNING] > Do **NOT** sign into the shared mailbox with a password. The feature APIs won't work in that case. ### [Mac](#tab/unix) +#### Shared folders + +The mailbox owner must first provide access to a delegate. For guidance, see [Add and manage delegates in Outlook for Mac](https://support.microsoft.com/office/49ba7631-1984-453e-8a8f-c78fd43475e4). + +Once access is provided, the delegate must then follow the instructions outline in [Become a delegate or stop being a delegate in Outlook for Mac](https://support.microsoft.com/office/818da19c-b03c-4a69-926a-76a7c84c3579). + #### Shared mailboxes A shared mailbox allows a group of users to easily monitor and send messages and meeting invites using a shared email address. For guidance on how to access a shared mailbox that you have permissions to in Outlook on Mac, see the "Open a shared or delegated mailbox" section of [Open a shared Mail, Calendar, or People folder in Outlook for Mac](https://support.microsoft.com/office/6ecc39c5-5577-4a1d-b18c-bbdc92972cb2). -Users with permissions to a shared mailbox can activate add-ins configured for shared mailbox scenarios in message and appointment read and compose modes. - -#### Shared folders +--- -If the **Inbox** folder is shared with a delegate, add-ins are available to the delegate in message read mode. +To learn more about where add-ins do and don't activate in general, refer to the [Mailbox items available to add-ins](outlook-add-ins-overview.md#mailbox-items-available-to-add-ins) section of the Outlook add-ins overview page. -If the **Drafts** folder is also shared with the delegate, add-ins are available in compose mode. +## Add-in support in shared folder and shared mailbox scenarios -#### Local shared calendar (new model) +### Add-ins in shared folder scenarios -If the calendar owner explicitly shared their calendar with a delegate (the entire mailbox may not be shared), add-ins are available to the delegate in appointment read and compose modes. +The following table outlines the availability of add-ins in shared folder scenarios. -#### Remote shared calendar (previous model) +| Scenario | Add-in availability | +| ----- | ----- | +| **Inbox** folder is shared with a delegate | Add-ins are available to the delegate in message read mode. | +| **Drafts** folder is shared with a delegate | Add-ins are available to the delegate in message compose mode. | +| Calendar is explicitly shared with a delegate (the entire mailbox may not be shared) | Add-ins are available to the delegate in appointment read and compose modes. | +| Calendar is shared with a group of users with different access (for example, made it editable to a particular distribution list or the entire organization) | Add-ins are available to users with indirect or implicit permissions in appointment read and compose modes. | -If the calendar owner granted broad access to their calendar (for example, made it editable to a particular DL or the entire organization), users may then have indirect or implicit permission and add-ins are available to those users in appointment read and compose modes. +### Add-ins in shared mailbox scenarios ---- +The following table outlines the availability of add-ins in shared mailbox scenarios. -To learn more about where add-ins do and don't activate in general, refer to the [Mailbox items available to add-ins](outlook-add-ins-overview.md#mailbox-items-available-to-add-ins) section of the Outlook add-ins overview page. +| Scenario | Add-in availability | +| ----- | ----- | +| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, the in-app Microsoft 365 and Copilot store doesn't appear on the ribbon. | +| Add-in installed by an administrator | While an administrator can deploy an add-in to a shared mailbox in the Microsoft 365 admin center, the add-in won't appear in the shared mailbox. As a workaround, an administrator can deploy an add-in to a user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | +| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, default add-ins are also available for use even if their manifest doesn't configure the shared folder setting. | +| Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | ## Configure the manifest @@ -123,7 +132,7 @@ To implement shared folder and shared mailbox scenarios in your add-in, you must > [!NOTE] > Implementing shared folder and shared mailbox scenarios with a unified manifest for Microsoft 365 is currently only supported in classic Outlook on Windows. For other supported platforms, use the add-in only manifest instead. -Add an additional object to the "authorization.permissions.resourceSpecific" array and set its "name" property to "Mailbox.SharedFolder". +Add an additional object to the ["authorization.permissions.resourceSpecific"](/microsoft-365/extensibility/schema/root-authorization-permissions#resourcespecific) array. Set its ["name"](/microsoft-365/extensibility/schema/root-authorization-permissions-resource-specific#name) property to "Mailbox.SharedFolder" and its ["type"](/microsoft-365/extensibility/schema/root-authorization-permissions-resource-specific#type) property to "Delegated". ```json "authorization": { @@ -209,7 +218,10 @@ The [DelegatePermissions](/javascript/api/outlook/office.mailboxenums.delegatepe Once you've identified that the current mail item is in a shared folder or shared mailbox, your add-in can then perform the necessary operations on the item within the shared environment. To run operations on an item in a shared context, you must first configure your add-in's permission in the manifest. Then, use Microsoft Graph to complete the operations. > [!NOTE] -> Exchange Web Services (EWS) isn't supported in shared folder and shared mailbox scenarios. +> +> - Exchange Web Services (EWS) isn't supported in shared folder and shared mailbox scenarios. +> +> - In delegate or shared scenarios, a delegate can get the [categories from the Outlook master list](/javascript/api/outlook/office.mastercategories) but can't add or remove categories from the list. ### Configure the add-in's permissions From 8aa713767e517fef6e1ef4c9896676becf780923 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Tue, 25 Mar 2025 18:24:32 -0700 Subject: [PATCH 02/10] Add default add-in scenario --- docs/outlook/delegate-access.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 4cc3a3383..ea20b9d60 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -120,7 +120,8 @@ The following table outlines the availability of add-ins in shared mailbox scena | ----- | ----- | | Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, the in-app Microsoft 365 and Copilot store doesn't appear on the ribbon. | | Add-in installed by an administrator | While an administrator can deploy an add-in to a shared mailbox in the Microsoft 365 admin center, the add-in won't appear in the shared mailbox. As a workaround, an administrator can deploy an add-in to a user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | -| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, default add-ins are also available for use even if their manifest doesn't configure the shared folder setting. | +| Default add-ins in Outlook (only applies to Outlook on the web while the shared mailbox is opened in a separate tab or window) | In Outlook on the web, default Outlook add-ins are available for use in a shared mailbox opened in a separate tab or window using the **Open another mailbox** option. | +| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator. | | Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | ## Configure the manifest From 7efe114a6730206e0f24f6c5cdc7c6c8f070a063 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Fri, 28 Mar 2025 15:38:56 -0700 Subject: [PATCH 03/10] Apply feedback from review --- docs/outlook/delegate-access.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index ea20b9d60..38836ac56 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -118,9 +118,9 @@ The following table outlines the availability of add-ins in shared mailbox scena | Scenario | Add-in availability | | ----- | ----- | -| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, the in-app Microsoft 365 and Copilot store doesn't appear on the ribbon. | -| Add-in installed by an administrator | While an administrator can deploy an add-in to a shared mailbox in the Microsoft 365 admin center, the add-in won't appear in the shared mailbox. As a workaround, an administrator can deploy an add-in to a user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | -| Default add-ins in Outlook (only applies to Outlook on the web while the shared mailbox is opened in a separate tab or window) | In Outlook on the web, default Outlook add-ins are available for use in a shared mailbox opened in a separate tab or window using the **Open another mailbox** option. | +| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, add-ins installed in a user's primary mailbox and the in-app Microsoft 365 and Copilot store don't appear on the ribbon. | +| Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | +| Default add-ins in Outlook (only applies to Outlook on the web when the shared mailbox is opened in a separate tab or window) | In Outlook on the web, default Outlook add-ins are available for use in a shared mailbox opened in a separate tab or window using the **Open another mailbox** option. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

In a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web, templates created with the My Templates add-in are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | | Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator. | | Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | From ee702127e9d6f8b2d303aaf1a472fb7e1235e894 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Thu, 3 Apr 2025 17:20:38 -0700 Subject: [PATCH 04/10] Apply suggestion from review --- docs/outlook/delegate-access.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 38836ac56..1e52cc686 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -114,15 +114,15 @@ The following table outlines the availability of add-ins in shared folder scenar ### Add-ins in shared mailbox scenarios -The following table outlines the availability of add-ins in shared mailbox scenarios. - -| Scenario | Add-in availability | -| ----- | ----- | -| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox.

In Outlook on the web, if a shared mailbox is opened in a separate browser tab or window using the **Open another mailbox** option, add-ins installed in a user's primary mailbox and the in-app Microsoft 365 and Copilot store don't appear on the ribbon. | -| Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | -| Default add-ins in Outlook (only applies to Outlook on the web when the shared mailbox is opened in a separate tab or window) | In Outlook on the web, default Outlook add-ins are available for use in a shared mailbox opened in a separate tab or window using the **Open another mailbox** option. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

In a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web, templates created with the My Templates add-in are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | -| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator. | -| Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | +The following table outlines the availability of add-ins in shared mailbox scenarios across various Outlook clients. Note that the behavior in Outlook on the web may differ depending on whether the shared mailbox is opened in the same panel as the user's primary mailbox or in a separate tab or window using the **Open another mailbox** option. + +| Scenario | Web (same tab or window), Windows (new and classic), and Mac | Web (separate tab or window) | +| ----- | ----- | ----- | +| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox. | Users can't install add-ins in a shared mailbox. The in-app Microsoft 365 and Copilot store and add-ins installed in a user's primary mailbox don't appear on the ribbon of the mailbox. | +| Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | The same limitation and recommendation on other platforms apply (see previous column). | +| Default add-ins in Outlook | Default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

When using the My Templates add-in, the templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | Similar to other platforms, default add-ins are also available in a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web.

When using the My Templates add-in, the templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | +| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | +| Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | An add-in's manifest must be configured to make it available in shared scenarios. See the previous "Add-in used in read mode" row. | ## Configure the manifest From 1b2c219881f3bfce0ed76a4f1e423d37ac5509e1 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Mon, 7 Apr 2025 17:15:00 -0700 Subject: [PATCH 05/10] Apply suggestions from review --- docs/outlook/delegate-access.md | 58 ++++++++++++++++++--------------- 1 file changed, 31 insertions(+), 27 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 1e52cc686..3066c0822 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -97,33 +97,6 @@ A shared mailbox allows a group of users to easily monitor and send messages and --- -To learn more about where add-ins do and don't activate in general, refer to the [Mailbox items available to add-ins](outlook-add-ins-overview.md#mailbox-items-available-to-add-ins) section of the Outlook add-ins overview page. - -## Add-in support in shared folder and shared mailbox scenarios - -### Add-ins in shared folder scenarios - -The following table outlines the availability of add-ins in shared folder scenarios. - -| Scenario | Add-in availability | -| ----- | ----- | -| **Inbox** folder is shared with a delegate | Add-ins are available to the delegate in message read mode. | -| **Drafts** folder is shared with a delegate | Add-ins are available to the delegate in message compose mode. | -| Calendar is explicitly shared with a delegate (the entire mailbox may not be shared) | Add-ins are available to the delegate in appointment read and compose modes. | -| Calendar is shared with a group of users with different access (for example, made it editable to a particular distribution list or the entire organization) | Add-ins are available to users with indirect or implicit permissions in appointment read and compose modes. | - -### Add-ins in shared mailbox scenarios - -The following table outlines the availability of add-ins in shared mailbox scenarios across various Outlook clients. Note that the behavior in Outlook on the web may differ depending on whether the shared mailbox is opened in the same panel as the user's primary mailbox or in a separate tab or window using the **Open another mailbox** option. - -| Scenario | Web (same tab or window), Windows (new and classic), and Mac | Web (separate tab or window) | -| ----- | ----- | ----- | -| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox. | Users can't install add-ins in a shared mailbox. The in-app Microsoft 365 and Copilot store and add-ins installed in a user's primary mailbox don't appear on the ribbon of the mailbox. | -| Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | The same limitation and recommendation on other platforms apply (see previous column). | -| Default add-ins in Outlook | Default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

When using the My Templates add-in, the templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | Similar to other platforms, default add-ins are also available in a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web.

When using the My Templates add-in, the templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | -| Add-in used in read mode | An add-in's manifest must be configured to make an add-in available in shared scenarios. The setting differs depending on the type of manifest your add-in uses.The add-in can be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | -| Add-in used in compose mode | An add-in installed in the user's primary mailbox by the user or administrator may need additional configuration depending on the Outlook client or how the shared mailbox is accessed. | An add-in's manifest must be configured to make it available in shared scenarios. See the previous "Add-in used in read mode" row. | - ## Configure the manifest To implement shared folder and shared mailbox scenarios in your add-in, you must first configure support for the feature in your manifest. The markup varies depending on the type of manifest your add-in uses. @@ -238,6 +211,37 @@ To implement your shared folder and shared mailbox scenarios, use Microsoft Grap > [!TIP] > To access Microsoft Graph APIs from your add-in, use MSAL.js nested app authentication (NAA). To learn more, see [Enable SSO in an Office Add-in using nested app authentication (preview)](../develop/enable-nested-app-authentication-in-your-add-in.md). +## Add-in support in shared folder and shared mailbox scenarios + +The availability of add-ins in a shared folder or shared mailbox varies depending on the scenario and Outlook client. + +> [!TIP] +> To learn more about where add-ins do and don't activate in general, refer to the [Mailbox items available to add-ins](outlook-add-ins-overview.md#mailbox-items-available-to-add-ins) section of the Outlook add-ins overview page. + +### Add-ins in shared folder scenarios + +The following table outlines the availability of add-ins in shared folder scenarios. + +| Scenario | Add-in availability | +| ----- | ----- | +| **Inbox** folder is shared with a delegate | Add-ins are available to the delegate in message read mode. | +| **Drafts** folder is shared with a delegate | Add-ins are available to the delegate in message compose mode. | +| Calendar is explicitly shared with a delegate (the entire mailbox may not be shared) | Add-ins are available to the delegate in appointment read and compose modes. | +| Calendar is shared with a group of users with different access (for example, made it editable to a particular distribution list or the entire organization) | Add-ins are available to users with indirect or implicit permissions in appointment read and compose modes. | + +### Add-ins in shared mailbox scenarios + +The following table outlines the availability of add-ins in shared mailbox scenarios across various Outlook clients. Note that the behavior in Outlook on the web may differ depending on whether the shared mailbox is opened in the same panel as the user's primary mailbox or in a separate tab or window using the **Open another mailbox** option. + +| Scenario | Web (same tab or window), Windows (new and classic), and Mac | Web (separate tab or window) | +| ----- | ----- | ----- | +| Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox. | Users can't install add-ins in a shared mailbox. The in-app Microsoft 365 and Copilot store doesn't appear on the ribbon of the mailbox. | +| Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | The same limitation and recommendation on other platforms apply (see previous column). | +| Default add-ins in Outlook | Default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization. | Similar to other platforms, default add-ins are also available in a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web. | +| Templates created using the My Templates add-in | Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | +| Add-in used in read mode | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | +| Add-in used in compose mode | In Outlook on the web (mailbox opened in the same window) and on Windows (new and classic), all add-ins installed in the user's primary mailbox are available for use. An add-in's manifest doesn't need additional configuration to support shared mailbox scenarios.

However, in Outlook on Mac, an add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | + ## Limitations Depending on your add-in's scenarios, there are a few limitations for you to consider when handling shared folder or shared mailbox situations. From 435ed5f327d06a5bc46ae4fea0a85d7e27ed0912 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Tue, 8 Apr 2025 11:52:12 -0700 Subject: [PATCH 06/10] Clarify default add-in support in Outlook on Mac --- docs/outlook/delegate-access.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 3066c0822..096e6c213 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -237,8 +237,8 @@ The following table outlines the availability of add-ins in shared mailbox scena | ----- | ----- | ----- | | Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox. | Users can't install add-ins in a shared mailbox. The in-app Microsoft 365 and Copilot store doesn't appear on the ribbon of the mailbox. | | Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | The same limitation and recommendation on other platforms apply (see previous column). | -| Default add-ins in Outlook | Default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization. | Similar to other platforms, default add-ins are also available in a shared mailbox accessed using the **Open another mailbox** option in Outlook on the web. | -| Templates created using the My Templates add-in | Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1) and [Can I create email templates in Outlook for Mac?](https://support.microsoft.com/office/6339b60e-2e5a-4aed-a9e6-2e7b5d7eb5a0). | +| Default add-ins in Outlook | In Outlook on the web and on Windows (new and classic), default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

In Outlook on Mac, default add-ins aren't available in a shared mailbox. | Default add-ins are available in a shared mailbox. | +| Templates created using the My Templates add-in | This only applies to Outlook on the web and on Windows (new and classic) since the My Templates add-in isn't supported in shared mailboxes on Outlook on Mac.

Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | | Add-in used in read mode | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | | Add-in used in compose mode | In Outlook on the web (mailbox opened in the same window) and on Windows (new and classic), all add-ins installed in the user's primary mailbox are available for use. An add-in's manifest doesn't need additional configuration to support shared mailbox scenarios.

However, in Outlook on Mac, an add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | From 27173a779270e47b861c550aa2334c0001c59957 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Tue, 8 Apr 2025 14:18:05 -0700 Subject: [PATCH 07/10] Fix typo --- docs/outlook/delegate-access.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 096e6c213..ed6c91a26 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -238,7 +238,7 @@ The following table outlines the availability of add-ins in shared mailbox scena | Add-in installed by the user | Users can't install add-ins in a shared mailbox. Add-ins installed by a user are added to the user's primary mailbox. | Users can't install add-ins in a shared mailbox. The in-app Microsoft 365 and Copilot store doesn't appear on the ribbon of the mailbox. | | Add-in installed by an administrator | Administrators shouldn't deploy add-ins to a shared mailbox. They should instead deploy an add-in to the user's primary mailbox. The user can then use the add-in in a shared mailbox as long as the add-in meets certain requirements (see the following scenarios for add-in availability in read and compose modes). | The same limitation and recommendation on other platforms apply (see previous column). | | Default add-ins in Outlook | In Outlook on the web and on Windows (new and classic), default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

In Outlook on Mac, default add-ins aren't available in a shared mailbox. | Default add-ins are available in a shared mailbox. | -| Templates created using the My Templates add-in | This only applies to Outlook on the web and on Windows (new and classic) since the My Templates add-in isn't supported in shared mailboxes on Outlook on Mac.

Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, others users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | +| Templates created using the My Templates add-in | This only applies to Outlook on the web and on Windows (new and classic) since the My Templates add-in isn't supported in shared mailboxes on Outlook on Mac.

Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, other users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | | Add-in used in read mode | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | | Add-in used in compose mode | In Outlook on the web (mailbox opened in the same window) and on Windows (new and classic), all add-ins installed in the user's primary mailbox are available for use. An add-in's manifest doesn't need additional configuration to support shared mailbox scenarios.

However, in Outlook on Mac, an add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | From 5c447b60776d105a1a826ed9d98465159cf1b75e Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Tue, 8 Apr 2025 15:34:58 -0700 Subject: [PATCH 08/10] Clarify wording --- docs/outlook/delegate-access.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index ed6c91a26..e470a6c0e 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -240,7 +240,7 @@ The following table outlines the availability of add-ins in shared mailbox scena | Default add-ins in Outlook | In Outlook on the web and on Windows (new and classic), default Outlook add-ins are available for use in a shared mailbox. Default Outlook add-ins can include My Templates, Unsubscribe, and Action Items. Note that some default add-ins may not appear in your organization.

In Outlook on Mac, default add-ins aren't available in a shared mailbox. | Default add-ins are available in a shared mailbox. | | Templates created using the My Templates add-in | This only applies to Outlook on the web and on Windows (new and classic) since the My Templates add-in isn't supported in shared mailboxes on Outlook on Mac.

Templates created are saved to the creator's primary mailbox. Although the creator can use these templates in both their primary and shared mailboxes, other users who have access to the shared mailbox can't access these templates. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | Templates created are saved to the shared mailbox. These templates can be edited or used by anyone with access to the shared mailbox as long as they open the mailbox using the **Open another mailbox** option. The shared templates can't be accessed by anyone, including the template creator, from other platforms. This includes Outlook on the web if the shared mailbox is opened in the same tab as the user's primary mailbox. Conversely, templates created on other platforms can't be accessed from a shared mailbox opened using the **Open another mailbox** option. For more information, see [Create an email message template](https://support.microsoft.com/office/43ec7142-4dd0-4351-8727-bd0977b6b2d1). | | Add-in used in read mode | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | The same manifest configuration and behavior on other platforms apply (see previous column). | -| Add-in used in compose mode | In Outlook on the web (mailbox opened in the same window) and on Windows (new and classic), all add-ins installed in the user's primary mailbox are available for use. An add-in's manifest doesn't need additional configuration to support shared mailbox scenarios.

However, in Outlook on Mac, an add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | +| Add-in used in compose mode | In Outlook on the web (mailbox opened in the same window) and on Windows (new and classic), add-ins installed in the user's primary mailbox that support compose mode are available for use. An add-in's manifest doesn't need additional configuration to support shared mailbox scenarios.

However, in Outlook on Mac, an add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). | An add-in's manifest must be configured to support shared mailbox scenarios. For more information, see [Configure the manifest](#configure-the-manifest). The add-in must be installed in the user's primary mailbox by the user or administrator. | ## Limitations From 3fe90a213f8883481b9f659c6ee95b55a8e7dae5 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Thu, 10 Apr 2025 17:55:39 -0700 Subject: [PATCH 09/10] Add suggestion from review --- docs/outlook/delegate-access.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index e470a6c0e..142cec88d 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -155,6 +155,15 @@ Under the parent **\** element, set the [SupportsSharedFolde Before you can run operations in a shared folder or shared mailbox, you must first identify whether the current folder or mailbox is shared. To determine this, call [Office.context.mailbox.item.getSharedPropertiesAsync](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods) on a message or appointment in compose or read mode. If the item is in a shared folder or shared mailbox, the method returns a [SharedProperties](/javascript/api/outlook/office.sharedproperties) object that provides the user's permissions, the owner's email address, the REST API's base URL, and the location of the target mailbox. +> [!NOTE] +> In Message Compose mode on Outlook on the web and on Windows (new or classic), certain conditions must be met to support the `Office.context.mailbox.item.getSharedPropertiesAsync` method in the following scenarios. +> +> - When a user has access to a shared folder from their mailbox. +> +> - When a user adds a shared mailbox to the same panel as their primary mailbox. +> +> For more information, see [Message Compose mode](#message-compose-mode). + The following example calls the `getSharedPropertiesAsync` method to identify the owner of the mailbox and the permissions of the delegate or shared mailbox user. ```javascript @@ -256,12 +265,15 @@ In Message Compose mode, [getSharedPropertiesAsync](/javascript/api/outlook/offi 1. They save the message then move it from their own **Drafts** folder to a folder shared with the delegate. 1. The delegate opens the draft from the shared folder then continues composing. -- **Shared mailbox** +- **Shared mailbox opened in the same panel as the user's primary mailbox** 1. A shared mailbox user starts a message. This can be a new message, a reply, or a forward. 1. They save the message then move it from their own **Drafts** folder to a folder in the shared mailbox. 1. Another shared mailbox user opens the draft from the shared mailbox then continues composing. + > [!NOTE] + > In Outlook on the web, the `getSharedPropertiesAsync` method is supported in a shared mailbox that's opened in a separate tab or window using the **Open another mailbox** option. There are no specific conditions to meet for the method to work. + Once these conditions are met, the message becomes available in a shared context and add-ins that support these shared scenarios can get the item's shared properties. After the message is sent, it's usually found in the **Sent Items** folder of the sender's personal mailbox. ### User or shared mailbox hidden from an address list From c40bc821eab69a3c2edc7edda745ad14044e3963 Mon Sep 17 00:00:00 2001 From: Sam Ramon <15154970+samantharamon@users.noreply.github.com> Date: Fri, 11 Apr 2025 12:49:30 -0700 Subject: [PATCH 10/10] Apply suggestion from review --- docs/outlook/delegate-access.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/docs/outlook/delegate-access.md b/docs/outlook/delegate-access.md index 142cec88d..71c7ccf07 100644 --- a/docs/outlook/delegate-access.md +++ b/docs/outlook/delegate-access.md @@ -156,13 +156,7 @@ Under the parent **\** element, set the [SupportsSharedFolde Before you can run operations in a shared folder or shared mailbox, you must first identify whether the current folder or mailbox is shared. To determine this, call [Office.context.mailbox.item.getSharedPropertiesAsync](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods) on a message or appointment in compose or read mode. If the item is in a shared folder or shared mailbox, the method returns a [SharedProperties](/javascript/api/outlook/office.sharedproperties) object that provides the user's permissions, the owner's email address, the REST API's base URL, and the location of the target mailbox. > [!NOTE] -> In Message Compose mode on Outlook on the web and on Windows (new or classic), certain conditions must be met to support the `Office.context.mailbox.item.getSharedPropertiesAsync` method in the following scenarios. -> -> - When a user has access to a shared folder from their mailbox. -> -> - When a user adds a shared mailbox to the same panel as their primary mailbox. -> -> For more information, see [Message Compose mode](#message-compose-mode). +> In Outlook on the web and on Windows (new and classic), when a shared folder or shared mailbox is opened in the same panel as the user's primary mailbox, the `getSharedPropertiesAsync` method requires certain conditions to be met in Message Compose mode. For more information, see the "Message Compose mode" section in [Limitations](#message-compose-mode). The following example calls the `getSharedPropertiesAsync` method to identify the owner of the mailbox and the permissions of the delegate or shared mailbox user.