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. 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

To configure email templates:

1. Log in to the LoginRadius Console.
2. Navigate to Branding > Email Templates.
3. You can create, view, or edit email templates as per your use case.

Create Email Template

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.
• 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.

Email Template Settings

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 vtoken for actions like email verification.
    Example: #Url#?vtype=emailverification&vtoken=#GUID#
  • OTP (One Time Password): Sends a time-limited OTP.
    Example: #OTP#

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.

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#

Related Resources

• Email Communications and Configuration
• Multiple SMTP Domains
• SMTP Providers