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

The mail provider to use to send system mail from WHMCS. The option that you choose can affect your mail deliverability and offers different levels of security through different providers.

For more information, see Mail Providers.

You can choose from the following options:

| Mail Provider | Configuration Requirements | | | PHP Mail (default) | When you configure this mail provider, you must 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.
| | | SMTP | When you configure this mail provider, you must choose an encoding type from Mail Encoding, select a service provider, and enter your credentials for the selected provider. | Use SMTP for System Mail
Use Google for System Mail | | MailGun | When you configure this mail provider, you must select a region, and then enter your sending domain and MailGun API key. | Use Other Providers for System Mail | | Microsoft |
This mail provider is only available in WHMCS 8.6 and later.
When you configure this mail provider, you must create a Microsoft Entra® ID (formerly Microsoft Azure®) app and then enter your Microsoft Entra ID authentication information. | Use Microsoft for System Mail | | SendGrid | When you configure this mail provider, you must enter your SendGrid API key. | Use Other Providers for System Mail | | SparkPost | When you configure this mail provider, you must select a SparkPost account and enter your SparkPost API key. Check Use Sink Testing to check email sending without actually sending emails. | Use Other Providers for System Mail |

When you configure your chosen mail provider, click Test Configuration to send a test email. If this test does not succeed, you will see an error message.

When you click Save for your mail provider configuration, the system will send an email to test your configuration. The system will not save the changes to your mail provider configuration unless the test succeeds.
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.

Whether to send outgoing mail. 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

Whether to disable RFC 3834 headers in outgoing mail. Set the toggle to ON to stop WHMCS from including these headers. RFC 3834 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

The text to append to all emails that your WHMCS installation sends that contain the {$signature} merge field and that will send to customers. You can include HTML.

The Global Email Signature setting in General Settings

Global Email CSS Styling

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

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.

Global Email Footer Content

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

The sender name that will appear on all email 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

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

The email addresses that you want to receive a blind carbon copy (BCC) of all emails that your WHMCS installation sends to customers.

The BCC Messages setting

Separate multiple email addresses with a comma.

Presales Form Destination

The support department that will receive messages from the pre-sales contact form.

If you do not want to select a support department, you can enter an email address for Presales Contact Form Email.

Presales Contact Form Email

The email address that will receive messages from the pre-sales contact form.

If you do not want to enter an email address, you can select a support department for Presales Form Destination.
general-settings mail-providers rfc-3834 mailgun smtp microsoft sendgrid sparkpost

Last modified: October 29, 2024