Skip to content

Commit 5fed3e5

Browse files
Merge pull request #213158 from csmulligan/csm-exid-inv-email-elements
[EXID] Content health review for invitation email elements
2 parents 9808bda + c2404c4 commit 5fed3e5

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

articles/active-directory/external-identities/invitation-email-elements.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: active-directory
66
ms.service: active-directory
77
ms.subservice: B2B
88
ms.topic: conceptual
9-
ms.date: 04/12/2021
9+
ms.date: 09/30/2022
1010

1111
ms.author: mimart
1212
author: msmimart
@@ -17,13 +17,13 @@ ms.collection: M365-identity-device-management
1717

1818
# The elements of the B2B collaboration invitation email - Azure Active Directory
1919

20-
Invitation emails are a critical component to bring partners on board as B2B collaboration users in Azure AD. While it’s [not required that you send an email to invite someone using B2B collaboration](add-user-without-invite.md), doing so gives the user all the information they need to make a decision about whether to accept your invite. It also gives them a link they can always refer to in the future when they need to return to your resources.
20+
Invitation emails are a critical component to bring partners on board as B2B collaboration users in Azure AD. It’s [not required that you send an email to invite someone using B2B collaboration](add-user-without-invite.md), but it gives the user all the information they need to decide if they accept your invite or not. It also gives them a link they can always refer to in the future when they need to return to your resources.
2121

2222
![Screenshot showing the B2B invitation email](media/invitation-email-elements/invitation-email.png)
2323

2424
## Explaining the email
2525

26-
Let's look at a few elements of the email so you know how best to use their capabilities.
26+
Let's look at a few elements of the email so you know how best to use their capabilities. These elements might look slightly different in some email clients.
2727

2828
### Subject
2929

@@ -36,34 +36,34 @@ The subject of the email follows this pattern:
3636
We use a LinkedIn-like pattern for the From address. This pattern should make it clear that although the email comes from [email protected], the invitation is from another organization. The format is: Microsoft Invitations <[email protected]> or Microsoft invitations on behalf of &lt;tenantname&gt;<[email protected]>.
3737

3838
> [!NOTE]
39-
> For the Azure service operated by 21Vianet in China, the sender address is [email protected].
40-
> For the Azure AD Government, the sender address is [email protected].
39+
> For the Azure service operated by [21Vianet in China](/azure/china), the sender address is [email protected].
40+
> For the [Azure AD Government](/azure/azure-government), the sender address is [email protected].
4141
4242
### Reply To
4343

4444
The reply-to email is set to the inviter's email when available, so that replying to the email sends an email back to the inviter.
4545

4646
### Phishing warning
4747

48-
The email starts with a brief warning to the user about phishing, alerting them that they should only accept invitations they're expecting. It’s good practice to make sure the partners you’re inviting will not be surprised by your invitation by mentioning it to them ahead of time.
48+
The email starts with a brief warning to the user about phishing, alerting them that they should only accept invitations they're expecting. It’s good practice to make sure the partners you’re inviting won't be surprised by your invitation by mentioning it to them ahead of time.
4949

5050
![Image of the phishing warning in the email](media/invitation-email-elements/phishing-warning.png)
5151

5252
### Inviter's information and invitation message
5353

54-
The email includes the name and primary domain associated with the organization sending the invitation. This information should help the invitee make an informed decision about accepting the invitation. If the inviter includes a message as part of their invitation when they [invite a guest user to the directory, group, or app](add-users-administrator.md) or when they [use the invitation API](customize-invitation-api.md), the message is highlighted in the main section of the email. Also included are the inviter’s name and profile image if they’ve set one. The message itself is a text area, so for security reasons, it doesn't process HTML tags.
54+
The email includes the name and primary domain associated with the organization sending the invitation. This information should help the invitee make an informed decision about accepting the invitation. The inviter can include a message as part of their invitation to the [directory, group, or app](add-users-administrator.md), or when they [use the invitation API](customize-invitation-api.md). The message is highlighted in the main section of the email. The inviter’s name and profile image are also included if they’ve set one. The message itself is a text area, so for security reasons, it doesn't process HTML tags.
5555

5656
![Image of the invitation message in the email](media/invitation-email-elements/invitation-message-inviters-info.png)
5757

58-
### Accept button and redirect URL
58+
### Accept invitation button or link and redirect URL
5959

60-
The next section of the email contains information about where the invitee will be taken after they accept the invitation, as well as a button to do so. In the future, the invitee can always use this link to return to your resources directly.
60+
The next section of the email contains information about where the invitee will be taken after they accept the invitation, and a button or link to do so. In the future, the invitee can always use this link to return to your resources directly.
6161

6262
![Image of the accept button and redirect URL in the email](media/invitation-email-elements/accept-button.png)
6363

6464
### Footer section
6565

66-
The footer contains more information about the invitation being sent. There is always an option for the invitee to block future invitations. If the organization has [set a privacy statement](../fundamentals/active-directory-properties-area.md), the link to the statement is displayed here. Otherwise, a note indicates the organization hasn't set a privacy statement.
66+
The footer contains more information about the invitation being sent. There's always an option for the invitee to block future invitations. If the organization has [set a privacy statement](../fundamentals/active-directory-properties-area.md), the link to the statement is displayed here. Otherwise, a note indicates the organization hasn't set a privacy statement.
6767

6868
![Image of the footer section in the email](media/invitation-email-elements/footer-section.png)
6969

0 commit comments

Comments
 (0)