Email Template Management
The Email Templates feature in LoginRadius allows you to design, customize, and manage email communications triggered by user authentication workflows and transactional events. The Email Templates section offers a refreshed layout with tabs by authentication type (Email, Passwordless, MFA, Risk Based, PIN, Smart Login, One Touch Login), a Templates Type sidebar, and the ability to create templates manually or with AI. These customizable templates ensure consistent branding and seamless interaction across various user journeys.
Use Case
In LoginRadius, email templates are used across multiple authentication and identity-related scenarios, including:
-
Account Registration: Send branded welcome emails and activation links when a user signs up through your LoginRadius registration flow.
-
Email Verification: Trigger email confirmation messages as part of the LoginRadius email verification process during registration or email updates.
-
Passwordless Login: Deliver secure one-time login links or verification codes to users, enabling passwordless authentication via LoginRadius.
-
Forgot Password: Support users in recovering their accounts by sending password reset links through LoginRadius’s Forgot Password API.
-
MFA (Multi-Factor Authentication): Enhance account security by sending email-based verification codes for the second step of LoginRadius MFA.
-
Security Alerts: These alerts notify users of account activity, such as failed login attempts or profile changes, and are powered by LoginRadius risk-based authentication triggers.
Configuration
The LoginRadius Console provides a user-friendly interface to manage all your email templates in one place. Whether creating a new template or customizing an existing one, the platform allows you to define the email template name, subject, sender details (Multiple SMTP Domains), and body content using dynamic placeholders. This ensures consistent branding and messaging across all user touchpoints.
Navigate to Email Templates
Create Email Template
Create with AI
Email Template Settings
To configure email templates:
- Log in to the LoginRadius Console.
- Navigate to Branding > Email Templates.
- Use + Create with AI (beside Add New Template) to generate a template with AI, or Add New Template to create one manually. You can also view, search, and edit existing templates from this page.
To create a new email template:
- Template Type: Select the type of email (e.g., Verification, Forgot Password, etc.).
- Template Name: Provide a unique, recognizable name for the template.
- Token Type: Choose between Magic Link or OTP:
- Magic Link: Generates a
vtokenfor actions like email verification.
Example:#Url#?vtype=emailverification&vtoken=#GUID# - OTP (One Time Password): Sends a time-limited OTP.
Example:#OTP#
- Magic Link: Generates a
- From Name: The Sender's name applicable to the Template.
- From Email: The Sender's email applicable to the Template.
- Subject Line: Enter the subject that will appear in the user’s inbox.
- Email Body: Use standard HTML along with LoginRadius placeholders to design the content of the email.
Note: To customize the sender's name and email, request LoginRadius support to enable the Multiple SMTP Domain feature. Learn more in the Multiple SMTP Domains documentation.
You can create a new email template using AI from the + Create with AI button on the Email Templates page. In the Add New Template with AI modal, provide the following:
- Template Type (required): Select the type of email (e.g., Add Email, Verification, Forgot Password, Welcome Email, etc.).
- Template Name (required): Enter a unique, recognizable name for the template.
- Template Styling (required): Choose how the generated template should be styled:
- Use Brand Styles: Creates a template using your existing brand styles (colors, fonts, etc.) so it automatically adapts across all your brands.
- Start Without Brand Styles: Designs a template without applying brand styles, giving you a single fixed design and full control over appearance.
- Prompt (required): Describe the email you want in the text area (e.g., "Generate an email for adding a new email address, but this one needs to use a magic link instead of a code."). A character limit applies (e.g., 1000 characters). Use Sample Prompt for example phrasing.
After filling all required fields, click Create Template to generate the template. You can then edit or deploy it like any other email template.
These optional settings are available for most templates (excluding the Welcome Email):
- Request Limit: This limit specifies how many times an email can be requested in a given time frame.
- Request Disable Period: Specifies how long (in minutes) further requests are blocked after the Request Limit is hit.
- Email Token Validity Limit: Determines how long (in minutes) the token in the email will remain valid.
- Token Type: Choose between Magic Link or OTP:
- Magic Link: Generates a
vtokenfor actions like email verification.
Example:#Url#?vtype=emailverification&vtoken=#GUID# - OTP (One Time Password): Sends a time-limited OTP.
Example:#OTP#
- Magic Link: Generates a
Reset Template
If you’ve customized a default email template and want to return it to its original version, use the Reset Template option.
Note: This is only available for default templates provided by the LoginRadius Identity Platform.
Branded Email Templates and Custom Domains
Behavior of Branded (dynamic) Email Templates depends on whether you use a single deployment or multiple custom domains, and on which domain (hub or custom) uses the v3 template.
- Without multiple custom domains: The v3 template must be deployed. Branded templates work as configured.
- With multiple custom domains: The v3 template must be mapped to at least one custom domain or the hub domain. When both v2 and v3 templates exist across domains, only the domain that has the v3 template will send emails with full branding; the editor may still show branded templates for all domains, but they render with correct branded styles only when the email is triggered from the domain that has v3.
| Scenario | Custom domain (e.g. abc.com) | Hub domain | Result |
|---|---|---|---|
| Case 1 | v2 template | v3 template | Branded templates appear in the editor but apply correct branded styles only when the email is triggered from the hub domain. |
| Case 2 | v3 template | v2 template | Branded templates appear in the editor but apply correct branded styles only when the email is triggered from the custom domain (e.g. abc.com). |
| Case 3 | v2 template | v2 template | Branded templates are not shown as branded in the editor: no branded styles, no brand/style toggle in the preview, and the explore-placeholders popup does not include branded placeholders. |
Existing static templates and previously created branded templates continue to work as before. Areas that fetch email templates (e.g. Customer Details, Orchestration Workflow Editor, Security PIN Authentication, Users – Add Customer) now use the same template data via the updated implementation.
Placeholder Tags
Below are the predefined placeholders that can be used in your email templates to dynamically personalize the content based on the user's profile or context. When the email is sent, these placeholders will be automatically replaced with actual values.
| Placeholder | Description |
|---|---|
| #Name# | Full name of the user as defined in the registration form. |
| #GUID# | A unique identifier is appended to the vtoken query parameter in the links. |
| #OTP# | A One-Time Password is used if the numeric code feature is enabled. |
| #Url# | URL passed via JavaScript options (verificationUrl, resetPasswordUrl). |
| #Providers# | Name of the social login provider used by the user. |
| #Email# | Registered email address of the user. |
| #FirstName# | First name from the user's profile. |
| #LastName# | Last name from the user's profile. |
| #Address1# | First line of the user's address. |
| #Address2# | Second line of the user's address. |
| #City# | City from the user's profile. |
| #Country# | Country from the user's profile. |
| #PostalCode# | Postal code from the user's profile. |
| #Region# | Region from the user's profile. |
| #State# | State from the user's profile. |
| #CurrentYear# | Automatically displays the current year. |
| #<CustomFieldName># | Displays the value of a custom field in the user's profile. |
| #IpAddress# | IP address of the user. |
| #UserAgent# | Browser user-agent string of the user. |
| #UserName# | Username, if username login is enabled on your site. |
Section Tags
When configuring Forgot Password Email templates, you should include either a password reset link, a list of connected social providers, or both. LoginRadius supports section tags that make parts of the email content removable during email rendering to include or exclude these sections based on the scenario conditionally.
If only one of the sections applies (e.g., password reset link or social ID providers), the other section must be excluded to ensure a clean and relevant message.
Supported Section Tags
| Tag | Purpose |
|---|---|
#FPass | Marks the start of the Password Reset section. |
FPass# | Marks the end of the Password Reset section. |
#FProv | Marks the start of the Forgot Provider section. |
FProv# | Marks the end of the Forgot Provider section. |
These tags allow the LoginRadius platform to include or exclude content blocks automatically, depending on the context.
Example Template
Hello #Name#, <br /><br />#FPassPlease reset your password by clicking on the link.<br />To Reset your password, please click on following link and if your browser does not open it, please copy and paste it in your browser’s address bar.<br /><br />#Url#?vtype=reset&vtoken=#OTP#<br /><br />FPass#<br /> <br /><br />Regards<br />Your Organization name <br/>
Provider : #Providers#