Skip to main content

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.

To configure email templates:

  1. Log in to the LoginRadius Console.
  2. Navigate to Branding > Email Templates.
  3. 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.

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.
ScenarioCustom domain (e.g. abc.com)Hub domainResult
Case 1v2 templatev3 templateBranded templates appear in the editor but apply correct branded styles only when the email is triggered from the hub domain.
Case 2v3 templatev2 templateBranded 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 3v2 templatev2 templateBranded 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.

PlaceholderDescription
#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

TagPurpose
#FPassMarks the start of the Password Reset section.
FPass#Marks the end of the Password Reset section.
#FProvMarks 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#