Email customization

Options in the Email tab allow you to customize default email notifications. Okta sends email notifications to end users for a variety of reasons, including:

  • User activation
  • Forgotten password
  • Reset password
  • Self-service unlock account

Email notifications are generated automatically and sent to end users according to your settings. You can also configure a custom email domain so that email Okta sends to your end users appears to come from an address that you specify instead of the default Okta sender.

Email Templates

Okta email templates contain default text suitable for a particular type of account activation, password reset, or account unlock scenario. You can customize the text of email templates in order to send end users custom Okta-generated email messages. The message can also be sent in multiple languages.

  • Email templates must be under 64 KB. This limit includes all text, HTML, and CSS characters in the template. 64 KB contains approximately 65,000 single-byte characters. If you use UTF-8, fewer characters are allowed because characters can be up to 4 bytes each. Styles may be stripped out by our template.
  • The Subject cannot exceed 128 characters.

For details, see Add Custom Email Templates for Multiple Languages.

This is an Early Access feature. To enable it, contact Okta Support.

Test Custom Email Templates

You can send yourself a test email to see how a custom email template will look and function. This can help you validate macro attributes and translations in the customized template as well as see how the template will render in different email environments. This eliminates the need to create a real end-to-end workflow to test customization. The test email will be sent to the primary email address of the admin initiating the test email.

Note: Free trial editions of Okta cannot create or send customized email templates.

Customize the text of an email template

  1. In the Admin Console, go to Settings > Email & SMS.
  2. On the Email tab, click one of the email templates listed in the left pane. The default message is displayed in text.
  3. Click Edit. Note that the message now appears as editable HTML.
  4. Edit the template as needed, and then click Save.
  5. Optional. You can add custom email templates in multiple languages.
  6. Optional. To delete all custom translations and revert to the standard Okta template, click Reset to Default.