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

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.

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

Create with AI

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.

Email Template Settings

These optional settings are available for most templates (excluding the Welcome Email):

• Request Limit: Specifies how many emails of a specific template type can be triggered for a particular user within a defined time frame. Maximum value: 10000.
• Request Disable Period: Specifies how long (in minutes) further requests are blocked after the Request Limit is hit. Maximum value: 43200 minutes (30 days).
• Email Token Validity Limit: Determines how long (in minutes) the token in the email will remain valid. Maximum value: 129600 minutes (90 days).
• 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.

Branded Email Styles

Branded (V3) email templates hydrate their placeholders from the Style applied on the Auth Studio page that triggered the email, so the message matches the branding the user sees on the login page. The Style that applies depends on the deployment, whether you run a single template, a custom domain, or multiple custom domains, and on whether a V2 or V3 template serves the request.

For the resolution rules across each deployment, including a worked multiple-custom-domain example, see Branded Email Style Resolution.

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.

Branding placeholders

Branding placeholders let a template adapt to the Style applied in Auth Studio. When a branded (V3) template is sent, each placeholder is hydrated with the value of the Style CSS variable it maps to, so the email carries the same colors, typography, and layout the user sees on the login page. Which Style supplies those values is decided by the deployment, covered in Branded Email Style Resolution.

Two placeholders are not backed by a CSS variable. #TemplateName# resolves to the name of the Auth Studio template, and #StyleName# resolves to the name of the applied Style set.

Note: Placeholder hydration runs only for V3 template deployments. A legacy V2 template renders these placeholders as literal text, so set static branding values directly in a V2 template.

The table below maps each branding placeholder to the Style CSS variable that supplies its value.

Placeholder	Source CSS variable	Controls
#LogoDisplay#	--sdk-show-logo	Whether the logo is shown.
#LogoUrl#	--sdk-logo-url	Logo image URL.
#PrimaryColor#	--sdk-brand-primary-color	Brand primary color.
#FontFamily#	--sdk-font-family	Font family.
#Background#	--page-background	Page background.
#PrimaryTextColor#	--sdk-card-text-color	Primary text color.
#SecondaryTextColor#	--sdk-card-subtext-color	Secondary text color.
#CardBackgroundColor#	--sdk-card-bg-color	Card background color.
#CardBoxShadow#	--sdk-card-box-shadow	Card box shadow.
#CardPaddingTop#	--sdk-card-padding-top	Card top padding.
#CardPaddingRight#	--sdk-card-padding-right	Card right padding.
#CardPaddingBottom#	--sdk-card-padding-bottom	Card bottom padding.
#CardPaddingLeft#	--sdk-card-padding-left	Card left padding.
#CardBorderColor#	--sdk-card-border-color	Card border color.
#CardBorderWidthTop#	--sdk-card-border-top-width	Card top border width.
#CardBorderWidthRight#	--sdk-card-border-right-width	Card right border width.
#CardBorderWidthBottom#	--sdk-card-border-bottom-width	Card bottom border width.
#CardBorderWidthLeft#	--sdk-card-border-left-width	Card left border width.
#CardBorderRadiusTopLeft#	--sdk-card-border-radius-top-left	Card top-left corner radius.
#CardBorderRadiusTopRight#	--sdk-card-border-radius-top-right	Card top-right corner radius.
#CardBorderRadiusBottomLeft#	--sdk-card-border-radius-bottom-left	Card bottom-left corner radius.
#CardBorderRadiusBottomRight#	--sdk-card-border-radius-bottom-right	Card bottom-right corner radius.
#PrimaryButtonColor#	--sdk-button-primary-bg-color	Primary button background color.
#PrimaryButtonTextColor#	--sdk-button-primary-text-color	Primary button text color.
#PrimaryButtonBorderColor#	--sdk-button-primary-border-color	Primary button border color.
#PrimaryButtonBorderRadius#	--sdk-button-primary-radius	Primary button border radius.
#PrimaryButtonBoxShadow#	--sdk-button-primary-shadow	Primary button box shadow.
#SecondaryButtonColor#	--sdk-button-secondary-bg-color	Secondary button background color.
#SecondaryButtonTextColor#	--sdk-button-secondary-text-color	Secondary button text color.
#SecondaryButtonBorderColor#	--sdk-button-secondary-border-color	Secondary button border color.
#SecondaryButtonBorderRadius#	--sdk-button-secondary-radius	Secondary button border radius.
#SecondaryButtonBoxShadow#	--sdk-button-secondary-shadow	Secondary button box shadow.
#LinkTextColor#	--sdk-link-text-color	Link text color.
#LinkFontWeight#	--sdk-link-font-weight	Link font weight.
#HeaderFontSize#	--sdk-header-font-size	Header font size.
#HeaderFontWeight#	--sdk-header-font-weight	Header font weight.
#SubHeaderFontSize#	--sdk-subheader-font-size	Subheader font size.
#SubHeaderFontWeight#	--sdk-subheader-font-weight	Subheader font weight.
#FooterTextColor#	--sdk-footer-text-color	Footer text color.
#FooterBackgroundColor#	--sdk-footer-bg-color	Footer background color.

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 ConfigurationMultiple SMTP DomainsSMTP Providers