- \n
- This feature is disabled for all new organizations by default. It has to be enabled for your account in order to be able to customize the emails you send to your users.\n
- \n
- Please reach out to either your Account Manager, or Customer Success Manager to have this enabled for your org.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
Considerations:<\/strong><\/p>\n\n\n\n
- \n
- If the feature is not currently enabled for your organization, but you have previously customized email(s),you\u00a0 will see these templates in a read-only state under Settings > Customize Email in Admin Portal. Emails will continue to be sent to users with the existing customized content as displayed under the Settings > Customize Email page. Templates may be reverted to the JumpCloud default content at any time.<\/li>\n<\/ul>\n\n\n\n
This feature is only available to paid customers. Free customers that have previously customized emails will see their templates in a read-only state under\u00a0Settings > Customize Email<\/strong>\u00a0in their Admin Portal. Emails will continue to be sent to users with the existing customized content as displayed under the\u00a0Settings > Customize Email<\/strong>\u00a0page. Templates may be reverted to the JumpCloud default content at any time.\u00a0<\/p>\n\n\n\n
Customizing Email Templates for Your Org<\/strong><\/h2>\n\n\n\n
Considerations<\/strong>:<\/p>\n\n\n\n
- \n
- Non-Western characters are supported.<\/li>\n\n\n\n
- HTML is not supported.<\/li>\n<\/ul>\n\n\n\n
You can customize the following email templates for your org:\u00a0<\/p>\n\n\n\n
- \n
- Lockout Notice<\/strong> – Tells users when they’re locked out of their account after multiple failed login attempts.<\/li>\n\n\n\n
- Password Expiration<\/strong> – Tells users that their password has expired and needs to be reset. <\/li>\n\n\n\n
- Password Expiration Warning<\/strong> – Encourages users to reset their password before its quickly approaching expiration date.<\/li>\n\n\n\n
- Password Reset Confirmation<\/strong> – Confirms a recent password change.<\/li>\n\n\n\n
- Password Reset<\/strong> – Asks new users to activate their account or reset their password.<\/li>\n\n\n\n
- Activation Email <\/strong>– Provides users with a token (link) to set their own initial password.<\/li>\n\n\n\n
- Welcome Email – Google Workspace<\/strong><\/li>\n\n\n\n
- Welcome Email – M365\/Azure AD<\/strong><\/li>\n<\/ul>\n\n\n\n
You can customize content in the following Email Content fields: <\/p>\n\n\n\n
- \n
- Subject<\/strong> – Content for the email\u2019s subject line.<\/li>\n\n\n\n
- Title<\/strong> – Content for the email\u2019s title that appears at the top of the email.<\/li>\n\n\n\n
- Header<\/strong> – Content for the email\u2019s header that appears after the title and before the message content. <\/li>\n\n\n\n
- Message<\/strong> – Content for the email\u2019s message. <\/li>\n\n\n\n
- Button Call to Action<\/strong> – Content for a button in the email message that calls for users to take an action, such as reset their password. <\/li>\n\n\n\n
- Footer<\/strong> – Content for the email\u2019s footer that appears below the message content.<\/li>\n<\/ul>\n\n\n\n
To customize an email template for your organization<\/strong>:<\/p>\n\n\n\n
- \n
- Log in to the JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n
- Click your initials in the right menu.<\/li>\n\n\n\n
- Select Administrators<\/strong>.<\/li>\n\n\n\n
- Select the Customize Email<\/strong> tab.\n
- \n
- You can also access these tabs by going to Settings<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Select the Email Template<\/strong> you want to customize.<\/li>\n\n\n\n
- Adjust the email content as needed. Use tokens to include content specific to your org, such as different email addresses, usernames, and contact names. Each template includes different editable fields. <\/li>\n<\/ol>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/note-icon.png\")
<\/p><\/div>Note:<\/strong> Each customized email has a JumpCloud Required field generated by JumpCloud, to verify the contents of the email being sent. This field is not editable. <\/p><\/div><\/div><\/div>\n\n\n\n
- \n
- As you edit fields, view the email’s content in the Template Preview. <\/li>\n\n\n\n
- Click save changes<\/strong>. The changes take effect immediately for all new emails sent by the template.<\/li>\n<\/ol>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/tip-icon.png\")
<\/p><\/div>Tip:<\/strong> Click ‘Reset to Default Content’ to clear any changes you’ve made and to return to the template’s original content. <\/p><\/div><\/div><\/div>\n\n\n\n
Customizing New User Welcome Emails<\/strong><\/h2>\n\n\n\n
You can customize the following new user welcome emails:<\/p>\n\n\n\n
- \n
- Activation Email<\/strong><\/li>\n\n\n\n
- Welcome Email – Google Workspace<\/strong><\/li>\n\n\n\n
- Welcome Email – M365\/Azure AD<\/strong><\/li>\n<\/ul>\n\n\n\n
If an email is not customized, it can be sent generically. New tokens are created as needed.<\/p>\n\n\n\n
<\/p><\/div>Note:<\/strong> When adding users via an Active Directory Sync or the API, a welcome email is sent to users, but that email is not customizable.<\/p><\/div><\/div><\/div>\n\n\n\n
Using Tokens in Email Templates<\/strong><\/h2>\n\n\n\n
Tokens are variables that are replaced with attributes for your org or your JumpCloud managed users. You can add tokens to email templates to include content that’s specific to your org and its users. <\/p>\n\n\n\n
Considerations<\/strong>:<\/p>\n\n\n\n
- \n
- Tokens have to be included exactly as they appear in the following list or they appear as plain text in emails. <\/li>\n\n\n\n
- If you mistype a token, it appears as plain text in the Template Preview. Valid tokens appear as links.<\/li>\n\n\n\n
- If a token attribute isn’t defined for your organization, the token appears as blank space in the email. <\/li>\n<\/ul>\n\n\n\n
You can include the following tokens in your email templates:<\/p>\n\n\n\n
#{admin_email_link}
This token is populated by your org’s contact name and contact email and shows the contact name with a mailto link to the contact email. If you don’t have both the contact name and contact email defined for your org, this token appears as a blank space in the email. You can update these under Settings, see Admin Portal General Settings<\/a> to learn more. <\/p>\n\n\n\n#{contact_email}
This token is populated by your org’s contact email. If you don’t have a contact email defined for your org, this token appears as a blank space in the email. You can update your org’s contact email under Settings, see Admin Portal General Settings to learn more. <\/p>\n\n\n\n#{contact_name}
This token is populated by your org’s contact name. If you don’t have a contact name defined for your org, this token appears as a blank space in the email. You can update your org’s contact name under Settings, see Admin Portal General Settings to learn more. <\/p>\n\n\n\n#{expiration_day}
This token is populated with a password’s expiration date and is only available for the Password Expiration Warning template. <\/p>\n\n\n\n#{first_name}
This token is populated by the receiving user’s first name. If you don’t have a first name defined for the user, this token appears as a blank space in the email.<\/p>\n\n\n\n#{lockout_source}
This token identifies the source of the last login failure that triggered the Lockout Email. This is either the System Display Name of the user\u2019s managed device, or User Portal.<\/p>\n\n\n\n
- Welcome Email – Google Workspace<\/strong><\/li>\n\n\n\n
- Activation Email<\/strong><\/li>\n\n\n\n
- Select the Email Template<\/strong> you want to customize.<\/li>\n\n\n\n
- Title<\/strong> – Content for the email\u2019s title that appears at the top of the email.<\/li>\n\n\n\n
- Password Expiration<\/strong> – Tells users that their password has expired and needs to be reset. <\/li>\n\n\n\n
- Lockout Notice<\/strong> – Tells users when they’re locked out of their account after multiple failed login attempts.<\/li>\n\n\n\n
- If the feature is not currently enabled for your organization, but you have previously customized email(s),you\u00a0 will see these templates in a read-only state under Settings > Customize Email in Admin Portal. Emails will continue to be sent to users with the existing customized content as displayed under the Settings > Customize Email page. Templates may be reverted to the JumpCloud default content at any time.<\/li>\n<\/ul>\n\n\n\n
- Please reach out to either your Account Manager, or Customer Success Manager to have this enabled for your org.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n