Daily.Entra.News
Aboutmerill.net
Microsoft Entra ID Governance

Customize Workflow Email

30 July 2026Updated+15 / −4 lines

In brief

In the message body, you can customize the email text to personalize it for each recipient. You can optionally include built-in user attributes, custom security attributes, directory extensions, and on-premises extension attributes by embedding them in the text. Before the email is sent, the placeholders are replaced with the actual user information.

What Entra admins need to know

Review the documentation change to determine whether it affects tenant configuration, security posture, or rollout plans.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

Open on Microsoft Learn ↗

The comparison below is an extract of the Microsoft Learn article showing only the changed content. Open the full article for complete context.

Format attributes within customized emails

To further personalize customized emails,In the message body, you can take advantage of dynamic attributes. By placing dynamiccustomize the email text to personalize it for each recipient. You can optionally include built-in user attributes, custom security attributes, directory extensions, and on-premises extension attributes by embedding them in your emails, you can specifically call out values such as athe text. Before the email is sent, the placeholders are replaced with the actual user's name, their generated Temporary Access Pass, or even their manager's email. information.

To use dynamic attributes within your customized emails, you must follow formatting rules. The proper format for user attributes is:

{{dynamic attribute}user.graphPropertyName}}

The following screenshot is an example of the proper format for dynamic attributes within a customized email:

When you're typing a dynamic attribute, the email is written in the following way:

Welcome to the team, {{userGivenName}user.displayName}}

We're excited to have you join our growing team and look forward to a successful and memorable journey together.

The following table shows examples of the dynamic attributes available within emails:

Attribute typeExamples
Built-in user attributes{{user.displayName}}, {{user.userPrincipalName}}, {{user.employeeHireDate}}, {{user.employeeLeaveDateTime}}, {{user.createdDateTime}}, {{user.employeeType}}, {{user.department}}, {{user.companyName}}, {{user.jobTitle}}
Temporary Access Pass{{temporaryAccessPass}}
Employee organizational data{{user.employeeOrgData/costCenter}}, {{user.employeeOrgData/division}}
Custom security attributes{{user.customSecurityAttributes/attributeSet/attribute}}
On-premises extension attributes{{user.onPremisesExtensionAttributes/extensionAttribute1}}
Manager attributes{{managerDisplayName}}, {{managerEmail}}

For a full list of dynamic attributes that you can use with customized emails, see Dynamic attributes within email.

Use custom branding and domain in emails sent via workflows