Why customise WHMCS email templates?

WHMCS default email templates are generic and often use American English and terminology. Customizing templates for your South African hosting business:

  • Adds your company branding and logo
  • Uses South African English spelling and terminology (e.g., "licence" instead of "license")
  • Includes relevant information for South African clients (e.g., EFT payment instructions)
  • Provides clear DirectAdmin login instructions specific to 0724 Hosting
  • Improves professionalism and client trust
  • Reduces support queries by providing clearer instructions

Accessing email templates

  1. Log in to WHMCS admin area
  2. Go to Setup → Email Templates
  3. You will see a list of all email templates organised by category
  4. Click a template name to edit it

Essential email templates to customise

1. Hosting Account Welcome Email

When sent: When a new hosting account is provisioned

Why important: First impression, contains login details

Key customisations:

  • Add your logo and company branding
  • Include DirectAdmin login URL (https://ca.yourbusiness.co.za or server hostname)
  • Explain what DirectAdmin is and what clients can do with it
  • Include links to getting started guides
  • Add support contact information
  • Provide nameserver information for domain setup

2. Invoice Created

When sent: When renewal invoices are generated

Key customisations:

  • Clarify South African payment methods (EFT, PayFast, credit card)
  • Include banking details for EFT payments
  • Explain payment reference format
  • Set appropriate tone (professional but friendly)

3. Invoice Payment Reminder

When sent: For overdue invoices

Key customisations:

  • Polite but firm reminder tone
  • Explain consequences of non-payment (suspension, termination)
  • Provide payment methods and support contact
  • Offer assistance if client is experiencing payment issues

4. Service Suspension Notice

When sent: When account is suspended for non-payment

Key customisations:

  • Clear explanation of why account was suspended
  • How to restore service (pay invoice)
  • Contact information for payment issues
  • Deadline before termination

5. Order Confirmation

When sent: Immediately after order is placed

Key customisations:

  • Thank customer for their order
  • Explain next steps (payment, provisioning)
  • Expected setup time
  • Contact information for questions

Using merge fields

Merge fields automatically insert client-specific information into emails. Common merge fields:

Client information

  • {$client_name} — Client's full name
  • {$client_first_name} — First name only
  • {$client_email} — Client email address
  • {$client_id} — Client ID number
  • {$client_company_name} — Company name

Service information

  • {$service_id} — Service ID
  • {$service_product_name} — Hosting plan name
  • {$service_domain} — Domain name
  • {$service_username} — DirectAdmin username
  • {$service_password} — DirectAdmin password
  • {$service_server_hostname} — Server hostname
  • {$service_next_due_date} — Next renewal date

Invoice information

  • {$invoice_id} — Invoice number
  • {$invoice_total} — Total amount due
  • {$invoice_date} — Invoice date
  • {$invoice_due_date} — Due date
  • {$invoice_link} — Link to view/pay invoice

Company information

  • {$company_name} — Your company name
  • {$company_domain} — Your domain
  • {$whmcs_url} — Your WHMCS client area URL

Example: Customised hosting welcome email

Subject: Your {$service_product_name} Hosting Account is Ready

Dear {$client_first_name},

Welcome to {$company_name}! Your hosting account has been activated and is ready to use.

Hosting Account Details:
Domain: {$service_domain}
Hosting Plan: {$service_product_name}
Server: South African hosting on DirectAdmin with LiteSpeed

DirectAdmin Control Panel Login:
URL: https://ca.yourbusiness.co.za
Username: {$service_username}
Password: {$service_password}

DirectAdmin is your hosting control panel where you can:
• Create and manage email accounts
• Upload website files
• Manage databases and install WordPress
• View usage statistics and backups

Nameservers (if pointing your domain to our hosting):
Primary: ns1.0724.co.za
Secondary: ns2.0724.co.za

Update these at your domain registrar. DNS changes can take up to 24 hours to propagate.

Getting Started Guides:
• Installing WordPress: {$whmcs_url}/knowledge-base/install-wordpress
• Creating email accounts: {$whmcs_url}/knowledge-base/create-email-account
• FTP setup: {$whmcs_url}/knowledge-base/ftp-account-setup

Need Help?
Email: support@yourbusiness.co.za
Support Tickets: {$whmcs_url}/submitticket.php
Knowledge Base: {$whmcs_url}/knowledge-base

Thank you for choosing {$company_name} for your hosting needs.

Regards,
The {$company_name} Team

Example: South African invoice email

Subject: Invoice #{$invoice_id} from {$company_name} - Due {$invoice_due_date}

Dear {$client_first_name},

Your invoice for {$service_product_name} renewal is now available.

Invoice Details:
Invoice #: {$invoice_id}
Amount Due: R{$invoice_total}
Due Date: {$invoice_due_date}

Payment Methods:
• Online payment via credit card or PayFast: {$invoice_link}
• EFT/Bank Transfer:
  Bank: Standard Bank
  Account Name: Your Business Name
  Account Number: 123456789
  Branch Code: 051001
  Reference: INV{$invoice_id}
  
Important: Please use INV{$invoice_id} as your payment reference so we can allocate your payment correctly.

After making an EFT payment, please allow 24 hours for processing. Your service will be renewed automatically once payment is received.

Questions?
Contact us at accounts@yourbusiness.co.za or submit a ticket at {$whmcs_url}/submitticket.php

Thank you for your continued business.

Regards,
{$company_name} Billing

Email template best practices

  • Keep it concise: Clients scan emails quickly. Use bullet points and clear headings
  • Front-load important information: Put critical details (login, payment) at the top
  • Use South African terminology: "Licence" not "license", "R" for Rands, EFT not ACH
  • Include all relevant links: Client area, knowledge base, support ticket system
  • Add contact information: Email, phone (if applicable), support ticket link
  • Test emails: Send test emails to yourself to verify formatting and merge fields
  • Mobile-friendly: Keep lines short and avoid complex formatting
  • Professional tone: Friendly but professional. Avoid being too casual
  • Proofread: Check spelling, grammar, and ensure all merge fields work correctly

Customizing email appearance

Add your logo

To add your logo to emails:

  1. Upload your logo to your WHMCS installation (e.g., /assets/logo.png)
  2. In email templates, add: <img src="{$whmcs_url}/assets/logo.png" alt="{$company_name}" width="200">
  3. Place at the top of important templates (welcome email, invoices)

HTML vs plain text

WHMCS supports both HTML and plain text emails:

  • HTML emails: Allow formatting, images, and links but may be marked as spam
  • Plain text: More reliable delivery, better for transactional emails
  • Recommendation: Use plain text for invoices and reminders, HTML for welcome/marketing emails

South African-specific customisations

Payment instructions

Always include:

  • EFT/bank transfer details with all required fields
  • PayFast or local payment gateway information
  • Clear payment reference format (invoice number)
  • Processing time expectations (24 hours for EFT)

Language and spelling

  • Use South African English spelling (licence, colour, centre)
  • Avoid American terminology (e.g., "zip code" → "postal code")
  • Use "R" for currency, not "$"
  • Date format: DD/MM/YYYY or "23 June 2026"

Time zones

  • Reference SAST (South African Standard Time) when mentioning time
  • Business hours in SA format (08:00 - 17:00 SAST)

Testing email templates

Send test emails

  1. Go to Setup → Email Templates
  2. Edit a template
  3. Click Send Test Email
  4. Enter your email address
  5. Review the email for:
    • Correct merge field values
    • Proper formatting
    • Working links
    • No spelling errors

Test different scenarios

Test emails for:

  • New client signups
  • Clients with company names vs individuals
  • Services with different product names
  • Overdue invoices at different stages

Email deliverability

To ensure emails reach clients:

  • Configure SPF, DKIM, DMARC: For your WHMCS domain (e.g., mail from yourbusiness.co.za)
  • Use authenticated SMTP: Instead of PHP mail()
  • Avoid spam triggers: Don't use all caps, excessive exclamation marks, or spam words
  • Include unsubscribe link: For marketing emails (required by law)
  • Monitor bounce rates: Check WHMCS email logs for failed deliveries

Troubleshooting email template issues

Merge fields not working

If merge fields show as {$variable_name} instead of values:

  • Verify the merge field name is correct (case-sensitive)
  • Check that the data exists (e.g., service must exist for service merge fields)
  • Review WHMCS documentation for available merge fields per template
  • Test with a real client/service, not a test email

Emails not being sent

If emails are not sending:

  • Check WHMCS email settings: Setup → General Settings → Email
  • Verify SMTP settings if using external SMTP
  • Check Email Message Log: Utilities → Logs → Email Message Log
  • Test email functionality: Utilities → System → PHP Mail Test
  • Ensure cron is running for automated emails

Emails going to spam

If emails are marked as spam:

  • Configure SPF and DKIM for your sending domain
  • Use authenticated SMTP
  • Avoid spam trigger words (free, guaranteed, act now)
  • Keep a good text-to-image ratio
  • Include a physical address in footer
  • Warm up your sending domain gradually

Advanced email customisation

Using conditional logic

WHMCS templates support Smarty conditional logic:

{if $client_company_name}
Dear {$client_company_name} Team,
{else}
Dear {$client_first_name},
{/if}

Custom merge fields

Create custom merge fields via hooks for specialized data not available in default fields.

Getting help with email templates

If you need assistance customising WHMCS email templates, configuring email deliverability, or troubleshooting email issues, contact 0724 Hosting support. We can help with:

  • Creating professional South African hosting email templates
  • Setting up SPF, DKIM, and DMARC for WHMCS emails
  • Configuring SMTP for reliable email delivery
  • Troubleshooting email deliverability issues
  • Adding custom branding and logos to templates