Knowledgebase

SMTP Email Configuration in WHMCS

  • 0

SMTP Email Configuration in WHMCS

 

WHMCS uses email notifications to send invoices, support ticket updates, order confirmations, password resets, and other important communications to clients. Configuring SMTP email delivery ensures reliable email sending and improves deliverability compared to using PHP Mail.

 

Why Configure SMTP in WHMCS?

 

SMTP (Simple Mail Transfer Protocol) provides several benefits:

  • Improved email delivery rates

  • Better email authentication and security

  • Reduced risk of emails being marked as spam

  • Reliable delivery of invoices, notifications, and support emails

  • Compatibility with popular email providers such as Gmail, Microsoft 365, Zoho Mail, and custom mail servers

 

Accessing Mail Configuration Settings

 

To configure SMTP settings in WHMCS:

 

Step 1: Log in to WHMCS Admin Area

 

Access your WHMCS administration panel using your administrator credentials.

 

 

Step 2: Navigate to Mail Configuration

Go to:

  • Configuration Icon  → System Settings 

 

 

 

  • General Settings 

 

 

 

  • Mail

The Mail tab contains all email delivery settings.

 

 

 

Configuring SMTP Email Settings

 

Step 1: Select Mail Type

 

Under Mail Provider,  Click Configure Mail Provider

 

 

 choose:

SMTP

This instructs WHMCS to send emails through an SMTP server instead of PHP Mail.

 

 

 

 Enter SMTP Host

 

In the SMTP Host field, enter your mail server hostname.

Examples:

  • mail.yourdomain.com
  • smtp.gmail.com
  • smtp.office365.com
  • smtp.zoho.com

 

 Enter SMTP Port

 

Specify the SMTP port provided by your email service provider.

Common ports include:

Port Encryption
25 None
465 SSL
587 TLS

 

 

 

 

Step 2: Select SMTP SSL Type

 

Choose the appropriate encryption method:

  • None
  • SSL
  • TLS

Most modern email providers recommend TLS (Port 587).

 

 

 Enter SMTP Username

 

Provide the full email address used for authentication.

Example:

support@yourdomain.com

 

 

 Enter SMTP Password

 

Enter the password for the SMTP email account.

Ensure the password is correct to avoid authentication errors.

 

 

 

 

Step 3: Save Changes

 

Click Save Changes to store your SMTP configuration.

 

 

 

Testing SMTP Configuration

 

After saving the settings:

  1. Navigate to Configuration → System Settings → General Settings → Mail.
  2. Use the Test Mail Configuration option.
  3. Enter a destination email address.
  4. Send a test email.
  5. Verify that the email is received successfully.

 

Benefits of Configuring Mail Settings in WHMCS

 

  1. Improves Email Deliverability
    Ensures invoices, support updates, and notifications reach clients reliably.

  2. Enhances Professional Branding
    Allows you to customize sender names, signatures, and email templates with your company branding.

  3. Supports Automated Client Communication
    Automatically sends order confirmations, payment reminders, and support ticket updates.

  4. Reduces the Risk of Emails Being Marked as Spam
    Proper mail configuration helps improve email reputation and inbox placement.

  5. Centralizes Email Management
    Provides a single location to manage outgoing email settings, monitoring, and notifications within WHMCS.

 

 

Conclusion

 

Proper SMTP Email Configuration in WHMCS ensures reliable delivery of invoices, support notifications, order confirmations, and other important client communications. By configuring the correct SMTP server settings and testing email delivery, you can improve email reliability and provide a better experience for your customers.


Was this answer helpful?