Skip to content

Commit 38727ef

Browse files
[Outlook] (manifest) Update localhost guidance for AppDomain element (#2224)
1 parent 1268202 commit 38727ef

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

docs/manifest/appdomain.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: AppDomain element in the manifest file
33
description: Specifies additional domains that are used by your add-in and should be trusted by Office.
4-
ms.date: 07/14/2022
4+
ms.date: 03/11/2025
55
ms.localizationpriority: medium
66
---
77

@@ -22,10 +22,10 @@ Specifies an additional domain that Office should trust, in addition to the one
2222

2323
> [!IMPORTANT]
2424
>
25-
> 1. The value of the **\<AppDomain\>** element must include the protocol (e.g., `<AppDomain>https://myappdomain.com</AppDomain>`), and the protocol must be either `http` or `https`.
26-
> 1. If there is an explicit port for the domain, include it (e.g.,`<AppDomain>https://myappdomain.com:9999</AppDomain>`).
27-
> 1. If a subdomain needs to be trusted, include it (e.g.,`<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>`). The subdomain `mysubdomain.mydomain.com` and `mydomain.com` are different domains. If both need to be trusted, then both need to be in separate **\<AppDomain\>** elements.
28-
> 1. Listing the same domain as the one specified in the [SourceLocation element](sourcelocation.md) has no effect and may be misleading. In particular, when you are developing on `localhost`, you don't need to create an **\<AppDomain\>** element for `localhost`.
25+
> 1. The value of the **\<AppDomain\>** element must include the protocol (for example, `<AppDomain>https://myappdomain.com</AppDomain>`), and the protocol must be either `http` or `https`.
26+
> 1. If there is an explicit port for the domain, include it (for example,`<AppDomain>https://myappdomain.com:9999</AppDomain>`).
27+
> 1. If a subdomain needs to be trusted, include it (for example,`<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>`). The subdomain `mysubdomain.mydomain.com` and `mydomain.com` are different domains. If both need to be trusted, then both need to be in separate **\<AppDomain\>** elements.
28+
> 1. Listing the same domain as the one specified in the [SourceLocation element](sourcelocation.md) has no effect and may be misleading. When developing on `localhost`, you don't usually need to create an **\<AppDomain\>** element for it. However, if you're implementing the [Dialog API](/office/dev/add-ins/develop/dialog-api-in-office-add-ins) in an add-in that runs on Outlook on the web or the [new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627), you must create an **\<AppDomain\>** element for `localhost`.
2929
> 1. Don't include any segments of a URL past the domain. For example, don't include the full URL of a page.
3030
> 1. Do *not* put a closing slash, "/", on the value.
3131
> 1. Wildcards, such as `*`, aren't allowed in **\<AppDomain\>** values; however, *for add-ins running only in Office on Windows*, there's a way to designate additional trusted domains with wildcards. See [Wildcard trusted domains](/office/dev/add-ins/develop/trusted-domains).

0 commit comments

Comments
 (0)