Customize an email template

Okta sends email notifications to users when they reset their password, activate their account, unlock their account, and enroll or authenticate with an email authenticator. These notifications are available as customizable templates in each Okta-supported language.

You can customize any email template, but if you edit a template, Okta stops sending the default in other languages. You are responsible for adding translations of your customized message.

Note

Identity Engine templates are identical to those in Classic Engine orgs. However, the following templates require updates to include variables.

  • LDAP Forgot Password
  • Reset Factor
  • Active Directory Password Reset
  • Unlock Factor
  • Active Directory Password Unlock

Refer to the template descriptions for details.

Edit a default email template

  1. In the Admin Console, go to Customizations > Emails.
  2. Click a default email template listed in the left pane.
  3. Click Edit to open the message in HTML. If you see Add Translation instead of Edit, the template has already been customized. You need to make any additional edits in the default language version. Skip to step 2 in Add translations.
  4. Make your edits. Note the following limits:
    • The maximum size of an email template is 64 KB. This is the equivalent of approximately 65,000 single-byte characters (text, HTML, and CSS). UTF-8 characters can be as large as 4 bytes each, so fewer of these characters are accepted.

    • The Subject can't exceed 128 characters.

    • Some styles may be stripped out of templates.

  5. Click Save. The default language version of your edited message appears in the Custom Email table.

Okta doesn't automatically translate the changes you make in one template to the other language templates. To add translations for this customization, proceed to step 3 in Add translations.

See Use customizable email templates for a complete explanation of all the email templates available to an org.

Add translations

  1. In the Admin Console, go to Customizations > Emails.
  2. Choose an email template that you've customized. The default language version appears in the Custom Email table.
  3. Click Add Translation, and then select a language from the drop-down box. If the Add Translation button isn't available, this template hasn't been customized. See Edit a default email template.
  4. Make your translated edits, and then click Add Translation.
  5. Repeat steps 3 and 4 for more languages.

To delete all custom translations and revert to the Okta template, click Reset to Default.

Next steps

Velocity Templating Language

Test a customized email template