Overview
Email Template Customization allows you to create professionally branded emails for user registration, password resets, two-factor authentication, and administrative notifications with merge tags and custom designs.
Why Customize Email Templates?
Match emails to your brand with custom colors, logos, and messaging.
Use merge tags to address users by name and include dynamic content.
Clear, well-designed emails improve engagement and reduce confusion.
Create templates in different languages for international audiences.
Accessing Email Settings
Navigate to:
WordPress Admin → Settings → Attributes User Access → Email Templates
Available Email Templates
Authentication Emails
Welcome Email
When: New user registration
To: New user
Purpose: Welcome and provide login details
Password Reset Request
When: User requests password reset
To: User
Purpose: Provide reset link and security info
Password Changed Confirmation
When: Password successfully changed
To: User
Purpose: Confirm change and security alert
Two-Factor Authentication Code
When: User logs in with 2FA enabled
To: User
Purpose: Provide verification code
Administrative Emails
New User Registration (Admin)
When: New user registers
To: Site administrators
Purpose: Notify of new registration for review/approval
User Awaiting Approval
When: Registration requires approval
To: Site administrators
Purpose: Pending user awaiting review
Email Template Editor
Accessing Template Editor
For each email type:
- Go to Email Templates
- Find email type (e.g., “Welcome Email”)
- Toggle “Enable” switch
- Click “Configure” to expand settings
- Edit subject and content
- Preview changes
- Send test email
- Save changes
Template Structure
Basic structure:
Subject Line
[Dynamic merge tags supported]
Email Body
[HTML and merge tags supported]
Includes:
- Header with logo/branding
- Main content area
- Call-to-action buttons
- Footer with site info
Merge Tags Reference
User Information
Available merge tags:
{user_login} – Username
{user_email} – Email address
{user_display_name} – Display name
{first_name} – First name
{last_name} – Last name
{user_id} – User ID number
Example usage:
Hello {first_name} {last_name},
Your username is: {user_login}
Email: {user_email}
Renders as:
Hello John Doe,
Your username is: johndoe
Email: john@example.com
Site Information
Available merge tags:
{site_name} – Site name (from Settings → General)
{site_url} – Home page URL
{admin_email} – Site admin email
{site_description} – Site tagline
Example usage:
Welcome to {site_name}!
Visit us at: {site_url}
Questions? Email: {admin_email}
URLs and Links
Available merge tags:
{login_url} – Custom or default login page
{registration_url} – Registration page
{reset_url} – Password reset URL (reset emails only)
{verification_url} – Email verification link
{dashboard_url} – User dashboard/profile
Example usage:
Need to reset your password?
Visit: {reset_url}
Date and Time
Available merge tags:
{current_date} – Today’s date
{current_time} – Current time
{registration_date} – When user registered
{current_year} – Current year (for copyright)
Example usage:
Registration Date: {registration_date}
Email sent: {current_date} at {current_time}
© {current_year} {site_name}. All rights reserved.
Security Information
Available merge tags:
{user_ip} – User’s IP address
{verification_code} – 2FA code (2FA emails only)
{expiry_minutes} – Code expiry time (2FA emails)
{reset_token} – Password reset token
Example usage (2FA email):
Your verification code: {verification_code}
This code expires in {expiry_minutes} minutes.
Login attempt from: {user_ip}
Customizing Welcome Email
Default Welcome Email
Subject:
Welcome to {site_name}!
Content:
Hello {first_name},
Welcome to {site_name}! Your account has been created successfully.
Login Details:
Username: {user_login}
Email: {user_email}
[Log In Now]
If you have any questions, feel free to contact us.
Regards,
{site_name} Team
Enhanced Welcome Email Example
Subject:
🎉 Welcome to {site_name}, {first_name}!
Content:
Hello {first_name} {last_name},
We’re thrilled to have you join {site_name}! Your account is now active and ready to use.
Your Account Details
Username: {user_login}
Email: {user_email}
Member Since: {registration_date}
What’s Next?
- Complete your profile
- Explore our features
- Join our community forum
Visit our Help Center or
email us at {admin_email}
Welcome aboard!
The {site_name} Team
This email was sent from {site_name} ({site_url})
Customizing Password Reset Email
Default Reset Email
Subject:
Password Reset Request for {site_name}
Content:
Hello {user_display_name},
You requested a password reset for your account on {site_name}.
Click the link below to reset your password:
{reset_url}
This link expires in 24 hours.
If you didn’t request this, ignore this email.
Regards,
{site_name} Team
Enhanced Reset Email Example
Subject:
🔒 Password Reset Request – {site_name}
Content:
Hi {first_name},
We received a request to reset the password for your {site_name} account.
Request Details:
• Time: {current_time}
• Date: {current_date}
• IP Address: {user_ip}
For security: This link can only be used once
Didn’t request this?
If you didn’t request a password reset, you can safely ignore
this email. Your password will remain unchanged.
Best Practices:
✓ Use a strong, unique password
✓ Never share your password
✓ Enable two-factor authentication
Stay secure,
{site_name} Security Team
Customizing 2FA Email
Default 2FA Email
Subject:
Your {site_name} Verification Code
Content:
Hello {user_display_name},
Your verification code is: {verification_code}
This code expires in {expiry_minutes} minutes.
Login attempt from: {user_ip}
Regards,
{site_name} Team
Enhanced 2FA Email Example
Subject:
🔐 Verification Code: {verification_code}
Content:
Hi {first_name},
{verification_code}
• Account: {user_login}
• Time: {current_time}
• IP Address: {user_ip}
• Expires: {expiry_minutes} minutes
Security Tips:
• Don’t share this code with anyone
• Code is single-use only
• Expires automatically for your protection
⚠️ Didn’t try to log in?
If this wasn’t you, your password may be compromised.
Reset your password immediately.
{site_name} Security Team
HTML and Styling
Adding Custom HTML
Allowed HTML tags:
, , - Headings
- Paragraphs
- Links
, - Bold text
, - Italic text
, , - - Lists
, - Containers
, , - Tables
,
- Line breaks/dividers
Inline CSS Styling
Example styled content:
Important Notice
Your account requires verification before full access.
Log In Now →
Pre-Built CSS Classes
Available classes:
.welcome-box - Highlighted welcome section
.info-box - Information callout (blue)
.warning-box - Warning message (yellow)
.error-box - Error/alert (red)
.success-box - Success message (green)
.cta-button - Call-to-action button
.code-box - Verification code display
.security-notice - Security alert section
Email Template Options
Template Selection
Available templates:
○ Default – Simple, text-based
○ Modern – Clean, professional design
○ Minimal – Ultra-clean, minimal branding
○ Custom – Upload your own HTML template
Branding Options
Configurable elements:
Logo: [Upload Image]
Logo Width: [200] px
Primary Color: #0073aa
Secondary Color: #005a87
Background Color: #f8f9fa
Text Color: #333333
Link Color: #0073aa
Preview and Testing
Preview Mode
Generate preview:
- Edit email template
- Click “Preview” button
- View with sample data populated
- Check formatting and layout
- Verify merge tags replaced correctly
Send Test Email
Testing workflow:
- Complete template edits
- Enter test email address
- Click “Send Test Email”
- Check inbox (and spam folder)
- Verify formatting in email client
- Test on mobile device
- Make adjustments if needed
- Re-test until perfect
Test on multiple clients:
✓ Gmail (desktop)
✓ Gmail (mobile app)
✓ Outlook (desktop)
✓ Outlook (web)
✓ Apple Mail (iPhone)
✓ Thunderbird
Best Practices
Keep It Simple
Avoid complex layouts. Many email clients strip advanced CSS. Use tables for layout if needed.
Test Thoroughly
Send test emails to multiple email providers. Gmail, Outlook, and Apple Mail render differently.
Use Inline CSS
Always use inline styles (style=”…”) rather than CSS classes. Better email client compatibility.
Include Plain Text Version
Always provide plain text alternative for accessibility and spam filter compatibility.
Clear Call-to-Action
Every email should have one clear action. Make buttons large and obvious.
Troubleshooting
Emails Look Broken
Solutions:
- Use inline CSS only (no external stylesheets)
- Use tables for layout instead of divs
- Avoid background images
- Test with Litmus or Email on Acid
- Simplify complex layouts
Merge Tags Not Replacing
Solutions:
- Verify correct syntax: {tag_name} with curly braces
- Check for extra spaces inside braces
- Ensure tag name is spelled correctly
- Verify tag is available for that email type
- Clear template cache and re-save
Images Not Displaying
Solutions:
- Use absolute URLs (https://yoursite.com/image.png)
- Verify image file accessible publicly
- Check image file size (keep under 200KB)
- Use common formats (JPG, PNG, GIF)
- Many clients block images by default (warn users)
Manage Consent
To provide the best experiences, we use technologies like cookies to store and/or access device information. Consenting to these technologies will allow us to process data such as browsing behavior or unique IDs on this site. Not consenting or withdrawing consent, may adversely affect certain features and functions.
Functional
Always active
The technical storage or access is strictly necessary for the legitimate purpose of enabling the use of a specific service explicitly requested by the subscriber or user, or for the sole purpose of carrying out the transmission of a communication over an electronic communications network.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistics
The technical storage or access that is used exclusively for statistical purposes.
The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
The technical storage or access is required to create user profiles to send advertising, or to track the user on a website or across several websites for similar marketing purposes.
0
Notifications