Branding Email Templates

You can brand the end user email invitation to make its appearance more familiar to your end users. Click Revert to Default Settings to clear the customizations.

You can customize the following email templates in all of your supported languages:

  • End User Invitation- Invite a user to connect their devices to get access to apps and configurations.
  • Password Reset Notification- The system sends reminder emails 7-days and a 24-hours prior to the password expiration for local accounts. This does not apply to LDAP accounts.

  • Registration Confirmation- Email sent after a user completes registration. You can use this to thank users for registering and to point them to more learning resources.

  • Policy Compliance Notification- Email sent when devices go out of compliance.

This section contains the following topics:

Previewing and testing an email template

You can preview and test the email templates. The test allows you to send an email based on the template to an email address you specify.

To preview and test an email template:

  1. Click Admin.
  2. Under Email Templates, click End User Invitation, Password Reset Notification, Registration Confirmation, or Policy Compliance Notification.
  3. Click the Preview and Test link associated with the email template you wish to preview and test.
  4. View the rendered template in the rendered template pane.
  5. Specify a test email address to which to send the test email.

    If the email address you specify belongs to a current user, the test email substitutes values for most of the email template variables, affording a very accurate idea of the user experience of the email. However, the test email does not substitute values for variables Ivanti Neurons for MDM generates at the time it generates an actual email invitation.

  6. Click Send Test Email.

Customizing the message headers

  1. Click Admin.
  2. Click Email Templates.
  3. Click the Edit icon link (under Actions column) associated with the email template you wish to edit.
  4. Provide new settings as desired for Email Display Name, From Email Address, and Reply-to Email Address.

    5. If you customize the From and Reply-To email addresses, it is recommended that you Allowlist the Email Relay Service to ensure that your emails aren't blocked by email SPAM filtering services. See this document for more information.

  5. Click Save.
  6. Review the preview of the email template and click Save.

Customizing an email template

  1. Select Admin > Branding > Email Templates.
  2. Select the template to edit, End User Invitation, Password Reset Notification, Registration Confirmation, or Policy Compliance Notification.
  3. Click the edit pen icon adjacent to the email template you wish to customize.







  4. Edit the subject line if desired.

  5. Edit the email template containing HTML elements in the body pane to customize the message content.

    You can use the variables displayed on the right in the body of the email. See Supported email variables.
  6. Click Preview to preview the email template as you create iterations to your satisfaction.
  7. When you are ready to save the template, click Preview. This renders the preview and provides a save function.







  8. Click Save if you are satisfied with the preview.

Allowlisted and Blockedlisted content in customized user invitation

While customizing the user invitation email template in End user invitation, there are a set of Allowlisted HTML tags and attributes that are allowed. There are also a list of Blockedlisted strings that are not allowed in the user invitation to prevent Cross Site Scripting (XSS) vulnerability.

You are allowed to use only the Allowlisted tags and attributes in the invitation email. The following table list the Allowlisted tags and the corresponding attributes that are allowed.

Some Allowlisted tags(Example: <big>) should not have any Allowlisted attribute and therefore are displayed blank.

Allowlisted Tags

Allowlisted Attributes
<big> []
<img>

["id","label","editable","height","border","src","style","width", "align", "class","cellpadding","alt","title","data-max-width","data-default"]
<strong> []
<singleline> ["label"]
<tbody> []
<!DOCTYPE> []
<h1> ["style"]
<h2> ["style"]
<hr> ["noshade","style"]
<h3> []
<body>

["style", "class", "bgcolor", "paddingwidth", "paddingheight", "offset", "toppadding", "leftpadding", "lang","link","vlink","border","cellspacing","cellpadding"]
<title> ["id"]
<head> []
<div> ["style","class","width","align","id"]
<br> []
<path> ["d"]
<ul> ["style"]
<html> ["xmlns","xmlns:mso","xmlns:msdt"]
<ol> ["start"]
<table>

["class","width","border","cellspacing","cellpadding","style","height","bgcolor",

"align","background"]
<a> ["href","style","target","rel","class","title"]
<b> []
<o:p> []
<svg> ["xmlns","class","viewbox","width","height","role","aria-labelledby"]
<center> []
<em> []
<i> []
<label> ["style"]
<td>

["valign","width","height","class", "cellpadding", "cellspacing","border","bgcolor","align", "style","colspan","id"]
<p> ["style","class","align"]
<u> []
<meta> ["name","content","http-equiv","charset"]
<multiline> ["label"]
<style> ["type","id"]
<li> ["style"]
<tr> ["style"]
<span> ["style","class","lang"]
<font> ["color"]

The following are the list of Blockedlisted strings that are not allowed in the customized user invitation.

  • Script, @import, ¼script¾, script>, <script, <script>, </script>, javascript, alert(, moz-binding, expression(, +ADw-SCRIPT+AD4- ,+ADw-/SCRIPT+AD4-, xml:base

  • Special characters and search for javascript or script

  • The meta content attribute containing "url=" case insensitive

  • The img src not containing .svg.

  • Attribute value containing "\00"

If any of the above Blockedlisted strings are used in the HTML content of the end user invitation, an error message is displayed when you click Preview. This error message lists the HTML content that is not allowed in the end user invitation. Edit and remove the HTML content that is not allowed and then click Preview to proceed further.

You will not be allowed to save the edited templates containing Blockedlisted HTML content.

Supported email variables

Ivanti Neurons for MDM offers several variables you can use to customize your email templates.

End user invitation variables

Variable Description
${userActivationUrl} The user activation URL - this is the hyperlink around the ${email.idp.invitation.get.started} text.
${clusterRegistrationUrl} The cluster registration URL - it is NOT found in the default template, but is referenced indirectly (via the ${email.idp.invitation.pg4} variable).

${productBrandName}

 The product brand name - this is defined as the <title> tag in the header of the default template.

${companyLogoUrl}

 The company Logo URL - this is the one image in the default template - it points to an image in the Mobilelron CDN.
${message:${email.idp.invitation.register.your.device} The register the user device title.
${message:${email.idp.invitation.title}} Email invitation title.
${message:${email.idp.invitation.pg1}} Verification that the user in on their device.
${message:${email.idp.invitation.get.started}} The email invitation Get Started text.
${message:${email.idp.invitation.pg2}} Login and registration instructions.
${message:${email.idp.invitation.pg3}} Email and apps pushed to the device information.
${message:${email.idp.invitation.pg4}} Registration information if the user is not on their device, which includes the cluster registration URL.
${message:${email.footer}} The email invitation footer that includes the company website label.
${companyWebsiteLabel} The company website label - it is NOT found in the default template, but is referenced indirectly (via the ${email.footer} variable) .

Password expiration notification variables

Variable Description
${passwordResetUrl} The password reset URL.

${productBrandName}

 The product brand name - this is defined as the <title> tag in the header of the default template.

${companyLogoUrl}

 The company Logo URL - this is the one image in the default template - it points to an image in the Mobilelron CDN.
${message:${password.expiration.notification.title}} The password expiration notification title.
${message:${password.expiration.notification.pg1}} The password expiration notification introductory paragraph.
${message:${email.password.reset.url.name}} The password reset URL name.
${message:${email.footer}} The email invitation footer that includes the company website label.
${companyWebsiteLabel} The company website label - it is NOT found in the default template, but is referenced indirectly (via the ${email.footer} variable) .

Registration confirmation variables

Variable Description

${productBrandName}

 The product brand name - this is defined as the <title> tag in the header of the default template.

${companyLogoUrl}

 The company Logo URL - this is the one image in the default template - it points to an image in the Mobilelron CDN.
${message:${email.confirmation.title}} The registration confirmation title.
${message:${email.confirmation.pg1}} The registration confirmation introductory paragraph.

Policy compliance variables

Variable Description
${policyMessageTitle} This variable will be replaced by the content that is entered into the subject line in the send email compliance action within the policy.
${policyMessageContent} This variable will be replaced by the content that is entered into the message portion in the send email compliance action within the policy.

${productBrandName}

 The product brand name - this is defined as the <title> tag in the header of the default template.

${companyLogoUrl}

 The company Logo URL - this is the one image in the default template - it points to an image in the Mobilelron CDN.
${message:${email.footer}} The email invitation footer that includes the company website label.
${companyWebsiteLabel} The company website label - it is NOT found in the default template, but is referenced indirectly (via the ${email.footer} variable) .

Custom user attribute variables

An admin can use custom user attributes as email variables in the customized email template under the following conditions: