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:

• 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: Click here to log in

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.

What’s Next?

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

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.

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},

Security Tips:

• Don’t share this code with anyone

• Code is single-use only

• Expires automatically for your protection

{site_name} Security Team

HTML and Styling

Adding Custom HTML

Allowed HTML tags:

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


<h3>Inline CSS Styling</h3>

<strong>Example styled content:</strong>

<pre><code class="language-html">
<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.
</div>

<a href="/%7Blogin_url%7D" 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:

• 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

Troubleshooting

Emails Look Broken

Merge Tags Not Replacing

Images Not Displaying