Shahid Malla

WHMCS Email Template Customization: Complete Guide

Shahid Malla Shahid Malla January 2, 2026 11 min read
WHMCS Email Template Customization: Complete Guide

Email is your primary communication channel with customers. Generic, template-looking emails damage your brand, while personalized, professional emails build trust and reduce support tickets. This guide shows you how to transform WHMCS emails into powerful customer communication tools.

Accessing Email Templates

Navigate to Setup → Email Templates in your WHMCS admin area. Templates are organized into categories:

  • General: Welcome emails, password resets, contact form responses
  • Product/Service: Renewals, suspensions, terminations
  • Domain: Registration confirmations, transfer notices
  • Invoice: Invoice creation, payment confirmations, reminders
  • Support: Ticket notifications, replies
  • Affiliate: Commission notifications, signups

Understanding Template Variables

WHMCS templates use Smarty syntax with curly braces for variables. Click "Available Merge Fields" when editing any template to see all available variables.

Common Variables

{$client_name} - Client's full name
{$client_first_name} - Client's first name only
{$client_email} - Client's email address
{$company_name} - Your company name
{$whmcs_url} - Your WHMCS URL
{$invoice_num} - Invoice number
{$invoice_total} - Invoice total amount
{$service_domain} - Domain associated with service
{$ticket_id} - Support ticket ID

Conditional Content

Use Smarty conditionals for dynamic content:

{if $client_language eq 'spanish'}
Gracias por su pago
{else}
Thank you for your payment
{/if}

{if $invoice_total > 100}
As a valued customer, here's a 10% discount code for your next order: LOYALTY10
{/if}

Designing Professional Templates

HTML Email Structure

Create responsive HTML emails that look good everywhere:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body style="margin: 0; padding: 0; background-color: #f4f4f4;">
    <table width="100%" cellpadding="0" cellspacing="0">
        <tr>
            <td align="center" style="padding: 40px 0;">
                <table width="600" cellpadding="0" cellspacing="0" style="background: white; border-radius: 8px;">
                    <!-- Header -->
                    <tr>
                        <td style="padding: 30px; text-align: center; background: #4F46E5; border-radius: 8px 8px 0 0;">
                            <img src="{$company_logo_url}" alt="{$company_name}" style="max-width: 200px;">
                        </td>
                    </tr>
                    <!-- Content -->
                    <tr>
                        <td style="padding: 40px 30px;">
                            {$email_body}
                        </td>
                    </tr>
                    <!-- Footer -->
                    <tr>
                        <td style="padding: 20px; text-align: center; background: #f8f8f8; border-radius: 0 0 8px 8px;">
                            <p style="color: #666; font-size: 12px;">
                                © {$current_year} {$company_name}
                            </p>
                        </td>
                    </tr>
                </table>
            </td>
        </tr>
    </table>
</body>
</html>

Branding Consistency

Maintain brand consistency across all emails:

  • Use your brand colors in headers and buttons
  • Include your logo in every email
  • Consistent font family (web-safe fonts for email)
  • Standard footer with contact information

Key Templates to Customize

Welcome Email

First impressions matter. Make your welcome email warm and helpful:

Subject: Welcome to {$company_name}, {$client_first_name}!

Hi {$client_first_name},

Welcome to {$company_name}! We're thrilled to have you on board.

Here's what happens next:
• Your account is set up and ready at {$whmcs_url}clientarea.php
• Your login email is {$client_email}
• Need help? Our support team responds within 2 hours

If you have any questions, just reply to this email or open a support ticket.

Best,
The {$company_name} Team

Invoice Email

Clear, actionable invoices reduce late payments:

Subject: Invoice #{$invoice_num} - {$invoice_total} Due {$invoice_date_due}

Hi {$client_first_name},

Your invoice #{$invoice_num} for {$invoice_total} is ready.

Due Date: {$invoice_date_due}
Amount: {$invoice_total}

[PAY NOW BUTTON - Link to {$invoice_link}]

Questions about this invoice? Reply to this email.

{$company_name}

Service Welcome

New hosting account emails should include everything the customer needs:

Subject: Your {$service_product_name} is Ready!

Hi {$client_first_name},

Great news! Your {$service_product_name} account is now active.

Login Details:
• Control Panel: {$service_server_hostname}/cpanel
• Username: {$service_username}
• Password: {$service_password}

Domain: {$service_domain}
Nameservers:
• ns1.{$company_domain}
• ns2.{$company_domain}

Getting Started:
• How to upload your website: {link}
• Setting up email: {link}
• Need help? Contact support: {link}

Welcome aboard!
{$company_name}

Advanced Personalization

Dynamic Content Based on Products

Send different content based on what the customer purchased:

{if $service_product_group == "VPS Hosting"}
Your VPS is configured with {$configoption1}GB RAM and {$configoption2} CPU cores.
{elseif $service_product_group == "Shared Hosting"}
Your hosting account includes unlimited email accounts and databases.
{/if}

Loyalty Recognition

Recognize long-term customers:

{if $client_years >= 3}
As a valued customer of {$client_years} years, we truly appreciate your loyalty.
{/if}

Testing Your Emails

Preview Mode

Always preview emails before saving. WHMCS shows a rendered preview with sample data.

Send Test Emails

Use the "Send/Resend Message" function on a test client to verify:

  • Template renders correctly
  • Variables populate properly
  • Links work correctly
  • Mobile display is acceptable

Email Testing Tools

Use tools like Litmus or Email on Acid to test across email clients:

  • Gmail
  • Outlook
  • Apple Mail
  • Mobile clients

Email Deliverability

SPF, DKIM, DMARC

Proper email authentication prevents spam filtering:

  • Configure SPF records for your sending domain
  • Enable DKIM signing in your SMTP provider
  • Implement DMARC for maximum deliverability

SMTP Configuration

Use a professional SMTP service instead of PHP mail:

  • Amazon SES
  • SendGrid
  • Mailgun
  • Postmark

Conclusion

Well-crafted email templates improve customer experience, reduce support tickets, and reinforce your brand with every interaction. Take the time to customize your WHMCS emails—the investment pays dividends in customer satisfaction and retention.

Need help redesigning your WHMCS email templates? I create custom, branded email templates that match your company's professional image and improve customer communication.

Need Custom Email Templates?

I design professional WHMCS email templates that reflect your brand and improve customer engagement.

Share this article:
Shahid Malla

About Shahid Malla

Expert

Full Stack Developer with 10+ years of experience in WHMCS development, WordPress, and server management. Trusted by 600+ clients worldwide for hosting automation and custom solutions.