Mail Tab

From WHMCS Documentation


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

You can access this tab at Configuration () > System Settings > General Settings or, prior to WHMCS 8.0, Setup > General Settings.

Mail Type or Mail Provider

Use the Mail Type or Mail Provider settings, depending on your WHMCS version, to choose how your installation sends mail. The mail provider you choose can affect your mail deliverability and offers different levels of security through different providers.

Configuring a Mail Provider in WHMCS 8.0 and later

For WHMCS 8.0 and later, Mail Provider displays your selected mail provider. To change and configure it:

  1. Click Configure Mail Provider.
  2. Choose a Mail Provider from the menu.
  3. Enter the information for your chosen provider:
    • 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.
    • SMTP — Enter the indicated information:
      • Select a Mail Encoding type.
      • Select a service provider. If you choose Google, see Setting Up Google As Your Mail Service Provider.
      • Enter an SMTP host. If you chose Google as your service provider, make certain to use smtp.google.com.
      • Enter the port on which your SMTP server operates. The port varies depending on the SSL type and your mail server configuration. Check with your mail server administrator for the appropriate port to use. These are the most commonly-used ports by SSL type:
        • None: 25 or 26
        • SSL: 465 or 587
        • TLS: 587
      • Select an authentication type. Oauth2 is only available if you selected Google for Service Provider.
      • Enter your authentication information. This depends on your chosen service provider and authentication type.
      • Specify whether to use a secure connection when communicating with your mail server using the SMTP SSL Type menu. Changes to this option will usually also require changing the SMTP Port value.
      • Check Debugging if you want to log debugging output at Configuration () > System Logs.
    • MailGun — Select a region, and then enter your sending domain and MailGun API key.
    • Microsoft — Enter your authentication information.
      • In order to use Microsoft® email services, you must set Friendly URLs to Friendly index.php or Full Friendly Rewrite in the General tab at Configuration () > System Settings > General Settings.
      • For complete setup steps, see Setting Up Microsoft As Your Mail Service Provider.
      • Check Debugging if you want to log debugging output at Configuration () > System Logs.
      • 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 allow you to check email sending without actually sending emails.
  4. Click Test Configuration. The system will send an email to test your configuration. If the test doesn't succeed, you will see an error.
  5. Click Save. The system will send an email to test your configuration, and it won't save your changes unless the test is successful.

Configuring a Mail Type in WHMCS 7.10 and earlier

For WHMCS 7.10 and earlier, use Mail Type to choose one of these options:

  • Use PHP Mail to send emails from inside WHMCS. This requires no further configuration, but some email providers may treat this email with increased suspicion.
  • Use your SMTP server to send emails. The related SMTP fields are required:
    • For SMTP Port, specify the port on which your SMTP server operates. This will usually vary depending on the SSL type and your particular mail server configuration.
      • Check with your mail server administrator for the appropriate port to use.
      • These are the most commonly-used ports by SSL type:
        • None: 25 or 26
        • SSL: 465 or 587
        • TLS: 587
    • For SMTP SSL Type, specify whether a secure connection is used when communicating with your mail server. Changes to this option will usually also require changing SMTP Port.

For step-by-step instructions, see Configuring WHMCS to Use SMTP in WHMCS 7.

Mail Providers and Mail Types

WHMCS supports the following mail providers:

  • PHP Mail
  • SMTP (with OAuth2 authentication via Google in WHMCS 8.0 and later)
  • MailGun (WHMCS 8.0 and later)
  • Microsoft (WHMCS 8.6 and later)
  • SendGrid (WHMCS 8.0 and later)
  • SparkPost (WHMCS 8.0 and later)
PHP Mail

When you choose PHP Mail, you won't need to configure any additional settings. PHP Mail is more likely to be considered spam by spam filtering applications.

SMTP

SMTP uses an SMTP server to send email. You will need to retrieve the SMTP configuration information from your control panel or hosting provider or from Google. The requirements depend on the authentication type you choose.

WHMCS 8.0 and later includes support for Google email. This includes OAuth2 to authorize app or service access and is more secure than traditional username-and-password authentication.

For steps to set up Google and the required Google app, see Setting Up Google As Your Mail Service Provider.

Microsoft

WHMCS 8.6 and later includes support for all Microsoft Azure® apps, like Hotmail®, Microsoft Outlook®, Microsoft 365®, Skype®, and several others. This includes OAuth2 to authorize app or service access and is more secure than traditional username-and-password authentication.

For steps to set up Microsoft and the required Microsoft Azure app, see Setting Up Microsoft As Your Mail Service Provider.

MailGun, SendGrid, and SparkPost

MailGun, SendGrid, and SparkPost are email service providers that allow you access to tools for improved mail deliverability and email validation.

To set this up, enter your information from your email service provider, including the API key.

Custom Modules

You can extend the selection of mail providers with custom modules. For more information, consult 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. For more information, see Disabling Outgoing Mail.

We recommend that you only enable this setting when you are testing updates or customizations on a development installation or while troubleshooting. The system creates a log entry at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Logs whenever you enable or disable this setting.

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.

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 be appended to all emails sent to customers by WHMCS containing the {$signature} merge field. HTML can be used here.

Global Email CSS Styling

Enter the CSS code to be used to format every email template sent to clients by WHMCS.

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

Global Email Header Content

Content entered in this field will be displayed at the top of every email template sent to clients. HTML can be used here.

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

Global Email Footer Content

Content entered in this field will be displayed at the bottom of every email template sent to clients. HTML can be used here.

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

System Emails From Name

The sender name that will appear on all emails sent to staff by WHMCS.

For example, these emails include Cron Job Activity, New Order Notification, and Automation Success/Failure Notifications.

System Emails From Email

The email address that will appear on all emails sent to staff by WHMCS. This address does not necessarily have to exist (for example, noreply@yourcompany.com).

BCC Messages

An email address entered here will receive a blind carbon copy of all emails sent to customers by WHMCS.

Presales Form Destination OR Presales Contact Form Email

The department or email address that will receive messages sent via the pre-sales contact form.