Email Template Customization (Pro)

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?

---

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:

1. Go to Email Templates
2. Find email type (e.g., "Welcome Email")
3. Toggle "Enable" switch
4. Click "Configure" to expand settings
5. Edit subject and content
6. Preview changes
7. Send test email
8. 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:

<a href="{login_url}">Click here to log in</a>

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.

<div className="welcome-box">
  <h2>Your Account Details</h2>
  <strong>Username:</strong> {user_login}<br />
  <strong>Email:</strong> {user_email}<br />
  <strong>Member Since:</strong> {registration_date}

<div className="cta-button">
  <a href="{login_url}">Access Your Account →</a>

<h3>What's Next?</h3>

- Complete your profile
- Explore our features
- Join our community forum

<div className="help-box">
  <strong>Need Help?</strong><br />
  Visit our <a href="{site_url}/help">Help Center</a> or
  email us at {admin_email}

Welcome aboard!<br />
The {site_name} Team

<hr />
<small>This email was sent from {site_name} ({site_url})</small>

---

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.

<div className="security-notice">
  <strong>⚠️ Security Alert</strong><br />
  Request Details:<br />
  • Time: {current_time}<br />
  • Date: {current_date}<br />
  • IP Address: {user_ip}

<div className="cta-button">
  <a href="{reset_url}">Reset My Password →</a>

<div className="info-box">
  <strong>Link expires:</strong> 24 hours from request time<br />
  <strong>For security:</strong> This link can only be used once

<strong>Didn't request this?</strong>
If you didn't request a password reset, you can safely ignore
this email. Your password will remain unchanged.

<strong>Best Practices:</strong>
✓ Use a strong, unique password
✓ Never share your password
✓ Enable two-factor authentication

Stay secure,<br />
{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},

<div className="code-box" style="text-align: center; font-size: 32px; font-weight: bold; padding: 20px; background: #f0f0f0; border-radius: 8px;">
  {verification_code}

<div className="info-box">
  <strong>Login Details:</strong><br />
  • Account: {user_login}<br />
  • Time: {current_time}<br />
  • IP Address: {user_ip}<br />
  • Expires: {expiry_minutes} minutes

<strong>Security Tips:</strong>
• Don't share this code with anyone
• Code is single-use only
• Expires automatically for your protection

<div className="warning-box">
  ⚠️ <strong>Didn't try to log in?</strong><br />
  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:

<h1>, <h2>, <h3> - Headings
<p> - Paragraphs
<a href=""> - Links
<strong>, <b> - Bold text
<em>, <i> - Italic text
<ul>, <ol>, <li> - Lists
<div>, <span> - Containers
<table>, <tr>, <td> - Tables
<br />, <hr /> - Line breaks/dividers

---

Inline CSS Styling

Example styled content:

<div style="background-color: #f8f9fa; border-left: 4px solid #0073aa; padding: 15px; margin: 20px 0;">
  <strong style="color: #0073aa;">Important Notice</strong><br />
  Your account requires verification before full access.

<a href="{login_url}" style="display: inline-block; background-color: #0073aa; color: #ffffff; padding: 12px 24px; text-decoration: none; border-radius: 4px; font-weight: bold;">
  Log In Now →
</a>

---

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:

1. Edit email template
2. Click "Preview" button
3. View with sample data populated
4. Check formatting and layout
5. Verify merge tags replaced correctly

---

Send Test Email

Testing workflow:

1. Complete template edits
2. Enter test email address
3. Click "Send Test Email"
4. Check inbox (and spam folder)
5. Verify formatting in email client
6. Test on mobile device
7. Make adjustments if needed
8. Re-test until perfect

Test on multiple clients:

✓ Gmail (desktop)
✓ Gmail (mobile app)
✓ Outlook (desktop)
✓ Outlook (web)
✓ Apple Mail (iPhone)
✓ Thunderbird

---

Best Practices

---

Troubleshooting

Emails Look Broken

---

Merge Tags Not Replacing

---

Images Not Displaying

---

articleRelated articles

• User Registration Management
• Two-Factor Authentication
• Password Policies