Skip to content

Update about email domains and custom email templates #5982

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
thomascavanagh-okta merged 2 commits into from
Feb 27, 2026
Merged

Update about email domains and custom email templates #5982

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0b4112c
Add context about email domains and custom email templates
thomascavanagh-okta Feb 20, 2026
dcaaf23
SME edits
thomascavanagh-okta Feb 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion packages/@okta/vuepress-site/docs/guides/custom-email/main/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ The [Brands API](https://developer.okta.com/docs/api/openapi/okta-management/man
* Email templates
* The Okta End-User Dashboard

You can brand these pages and templates without setting up a customized Okta URL domain.
You can brand these pages and templates without setting up a customized Okta URL domain. However, you must set up a custom email domain if you want your users to receive the branded email templates.

> **Note:** If you change any email code using the [Admin Console](#edit-a-default-email-template), your customizations may override the values of the Theme objects. To get your Theme object values back, reset the code editors in the Admin Console to the default settings.

Expand Down Expand Up @@ -489,6 +489,8 @@ Here are some examples:

You can send yourself a test email to see how a custom email template looks and functions. A test email can help you validate attribute-based variables and translations in the customized template. You can see how the template renders in different email environments and avoid creating end-to-end workflows to test customizations. The primary email address of the admin that initiates the test receives the email.

> **Note:** You can only send customized test emails if you've configured a custom email domain. If you don't have a custom email domain, test emails use the Okta default template and are sent from the Okta email domain.

1. Click the email icon to the right of the email template that you’ve customized. A list shows the sender and receiver of the email.
2. Click **Send test email**.

Expand Down