Mail

The Mail tab allows you to configure how emails and messages function in WHMCS.

The Mail tab in General Settings

You can access this tab at Configuration () > System Settings > General Settings.

Mail Provider

Choose a mail provider and then configure the related settings. The mail provider that you choose can affect your mail deliverability and offers different levels of security through different providers.

To change and configure your Mail Provider:

  1. Click Configure Mail Provider.
  2. Choose a mail provider from the menu and then configure the displayed settings:
    • PHP Mail (default) — Choose an encoding type from Mail Encoding. We recommend the 8bit encoding type unless you are experiencing character display issues with your system character set.
      PHP Mail is more likely to be considered spam by spam filtering applications.
    • SMTP — Choose an encoding type from Mail Encoding, select a service provider, and enter your credentials for the selected provider.
      For more information, see Use SMTP for System Mail, or, if you choose Google, see Use Google for System Mail.
    • MailGun — Select a region, and then enter your sending domain and MailGun API key.
    • Microsoft — Enter your Microsoft Azure® authentication information.
      For more information, see Use Microsoft for System Mail.
      This mail provider is only available in WHMCS 8.6 and later.
    • SendGrid — Enter your API key.
    • SparkPost — Select a SparkPost account and enter a SparkPost API key. Check Use Sink Testing to check email sending without actually sending emails.
  3. Click Test Configuration. The system will send an email to test your configuration. If the test doesn’t succeed, you will see an error.
  4. Click Save. The system will send an email to test your configuration, and it won’t save your changes unless the test is successful.
You can extend the selection of mail providers with custom modules. For more information, see our Mail Providers Developer Documentation.

Disable Email Sending

We added this setting in WHMCS 8.1.

Set the toggle to ON to stop WHMCS from sending any outgoing email. We recommend that you only enable this setting when you are testing updates or customizations on a development installation or while troubleshooting.

Disabling email sending in General Settings

The system creates a log entry at Configuration () > System Logs whenever you enable or disable this setting.

For more information, see Disable Outgoing Mail.

Disable RFC3834 Headers

Set the toggle to ON to stop WHMCS from including RFC 3834 headers in outgoing support emails. These headers prevent circular responses when both the sender and destination are using autoresponders.

Disabling RFC 3834 headers in General Settings

  • We added this setting in WHMCS 8.1.
  • In WHMCS 8.1 and later, WHMCS sends support emails with RFC 3834-compliant headers by default.
Regardless of the option that you choose for this setting, email piping and email importing won’t import email that contains the Auto-Submitted header.

Global Email Signature

Enter the text to append to all emails that your WHMCS installation sends to customers containing the {$signature} merge field. You can include HTML.

The Global Email Signature setting in General Settings

Global Email CSS Styling

Enter the CSS code to use to format every email template that your WHMCS installation sends to customers.

For more information and the default content, see Email Styling.

Global Email Header Content

Enter the header content to display at the top of every email template that your WHMCS installation sends to customers. You can include HTML.

For more information and the default content, see Email Styling.

Enter the footer content to display at the bottom of every email template that your WHMCS installation sends to customers. You can include HTML.

For more information and the default content, see Email Styling.

System Emails From Name

Enter the sender name that will appear on all emails that your WHMCS installation sends to admins.

For example, the system would use this sender name when it sends the Cron Job Activity, New Order Notification, and Automation Success/Failure Notifications email templates.

System Emails From Email

Enter the email address that will appear on all emails that your WHMCS installation sends to admins. This address does not have to exist (for example, [email protected]).

BCC Messages

Enter an email address to receive a blind carbon copy (BCC) of all emails that your WHMCS installation sends to customers.

The BCC Messages setting

Presales Form Destination OR Presales Contact Form Email

Enter the department or email address that will receive messages from the pre-sales contact form.

Last modified: June 14, 2024