Knowledgebase

How to Create Invoice Emails in WHMCS

  • 0

How to Create Invoice Emails in WHMCS

 

Email communication is a critical part of any hosting or online service business. WHMCS automatically sends invoice-related emails to customers whenever an invoice is generated, paid, overdue, or canceled. While WHMCS includes several default invoice email templates, there are situations where you may want to create a completely new invoice email template instead of modifying the existing ones.

Creating a new invoice email template allows you to maintain the original templates while designing custom invoice notifications tailored to your business requirements. This can be useful for promotional invoices, special billing notices, branded communications, or custom automation workflows.

In this guide, you'll learn how to create a new invoice email template in WHMCS from scratch.

 

Why Create  Invoice Emails in WHMCS?

 

Instead of editing the default invoice templates, creating a new template offers several advantages:

  • Preserves the original WHMCS email templates.
  • Allows testing without affecting live emails.
  • Supports custom branding and layouts.
  • Enables specialized invoice notifications.
  • Works with custom automation and third-party modules.
  • Simplifies template management for different customer groups.

 

Prerequisites

 

Before you begin, ensure that:

  • WHMCS is installed and accessible.
  • You have administrator privileges.
  • Email sending is configured in WHMCS.
  • You understand the purpose of the custom invoice email.

 

Step 1: Log in to the WHMCS Admin Area

 

Access your WHMCS administration panel using your administrator credentials.

After logging in, you'll have access to all configuration settings, including email templates.

 

 

 

Step 2: Navigate to Email Templates

 

From the WHMCS admin dashboard:

  • Navigate to  Configuration Icon → System Settings

 

 

 

 

  • Select Email Templates

This section contains all email templates used throughout WHMCS.

 

 

 

 

Step 3: Create New Email Template

 

In the Email Templates page:

  1. Click Create New Email Template.
  2. A form will appear requesting template details.

 

 

You will need to provide:

 

Email Type

Choose:

Invoice

This ensures the template can use invoice-related merge fields and variables.

 

 

 

Template Name

Enter a unique name such as:

  • Custom Invoice Notification
  • Premium Invoice Reminder
  • Special Billing Notice
  • Invoice Follow-Up Email

The template name helps administrators identify the template later.

 

 

 

 

  • Click Create.

 

 

 

 

Step 4: Configure the Email Subject

 

Create a clear and professional subject line.

Example:

Invoice #{invoice_num} from {$companyname}

Alternative examples:

Your Invoice is Ready - {$companyname}
Payment Reminder for Invoice #{invoice_num}

Using merge fields allows dynamic information to be inserted automatically.

 

 

 

 

Step 5: Design the Email Body

 

In the Message field, create the content for your invoice email.

Example:

<p>Hello {$client_name},</p>

<p>Thank you for choosing {$companyname}.</p>

<p>A new invoice has been generated for your account.</p>

<p>
Invoice Number: {$invoice_num}<br>
Due Date: {$invoice_date_due}<br>
Total Amount: {$invoice_total}
</p>

<p>
You can review and pay your invoice using the link below:
</p>

<p>
<a href="{$invoice_link}">View Invoice</a>
</p>

<p>
If you have any questions, please contact our support team.
</p>

<p>
Regards,<br>
{$companyname}
</p>

This creates a professional invoice notification while maintaining dynamic invoice information.

 

 

 

 

Step 6: Insert Available Merge Fields

 

WHMCS provides numerous merge fields for invoice templates.

Common invoice variables include:

Merge Field Purpose
{$client_name} Client Name
{$companyname} Company Name
{$invoice_num} Invoice Number
{$invoice_total} Invoice Total
{$invoice_date_due} Due Date
{$invoice_link} Invoice URL
{$client_email} Client Email

To view available variables:

  1. Click the Available Merge Fields section.
  2. Browse invoice-related variables.
  3. Insert the required placeholders into your template.

 

 

 

 

Step 7: Add Company Branding

 

To create a professional appearance, include:

  • Company logo
  • Brand colors
  • Contact information
  • Social media links
  • Website URL

You can use HTML formatting to customize the layout and improve readability.

 

 

 

 

Step 8: Save the Template

 

After completing the subject and message content:

  1. Review the template carefully.
  2. Click Save Changes.

Your new invoice email template is now stored in WHMCS.

 

 

 

 

Step 9: Test the Template

 

Before using the template in production:

  1. Open the newly created template.
  2. Use WHMCS testing options if available.
  3. Send a test email to yourself.
  4. Verify:
    • Subject line formatting
    • Merge field output
    • Links
    • Mobile responsiveness
    • Branding consistency

Testing helps identify formatting issues before customers receive the email.

 

Step 10: Use the Template in Automation or Custom Workflows

 

Since this is a newly created template, WHMCS will not automatically replace the default invoice emails.

You can use the template with:

  • Custom hooks
  • Automation workflows
  • Third-party modules
  • API integrations
  • Custom billing processes

This approach allows the default invoice emails to remain untouched while your custom template serves a specific purpose.

 

Best Practices

 

When creating a new invoice email template in WHMCS:

  • Use clear and professional language.
  • Keep the email concise.
  • Include payment instructions.
  • Test merge fields thoroughly.
  • Ensure mobile-friendly formatting.
  • Maintain consistent branding.
  • Avoid removing essential invoice information.

 

 

Conclusion

 

Creating a new invoice email template in WHMCS is an excellent way to customize billing communications without altering the platform's default templates. By creating a separate invoice template, you can preserve existing functionality while building specialized notifications that match your branding and business requirements. With proper testing and implementation, a custom invoice email template can improve customer communication, enhance professionalism, and support advanced billing workflows within WHMCS.


Was this answer helpful?