Add Application Names to the Okta New Sign-On Notification Emails
Last Updated:
Overview
Okta supports injecting application context into email templates using Velocity Templating Language (VTL) variables. Administrators can customize the New Sign-On Notification email template to include the specific application name, such as WebEx or O365. End users receive these customized emails when a new sign-on is detected for the specific application.
Applies To
- Okta Identity Engine (OIE)
- Email Customization
- Velocity Templating Language (VTL)
Solution
How is the application name added to the New Sign-On Notification email?
Customize the email by editing the HTML or text body of the notification template in the Okta Admin Console to insert the application label variable.
- In the Okta Admin Console, navigate to Customizations, and then select Brands.
- Select the appropriate brand, and then navigate to the Emails tab.
- Locate and select the New Sign-On Notification template.
- Select Edit to open the code editor.
- Insert the
${app.label}(the friendly display name of the application) or${app.name}(the system name) variable into the subject line or body where the application name must appear. For example: "A new sign-in was detected for${app.label}." - Select Save and Publish.
NOTE: Test this configuration in a Preview environment to ensure it functions as intended before deploying to production.
