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

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:
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:
- Navigate to Configuration → System Settings → General Settings → Mail.
- Use the Test Mail Configuration option.
- Enter a destination email address.
- Send a test email.
- Verify that the email is received successfully.
Benefits of Configuring Mail Settings in WHMCS
-
Improves Email Deliverability
Ensures invoices, support updates, and notifications reach clients reliably. -
Enhances Professional Branding
Allows you to customize sender names, signatures, and email templates with your company branding. -
Supports Automated Client Communication
Automatically sends order confirmations, payment reminders, and support ticket updates. -
Reduces the Risk of Emails Being Marked as Spam
Proper mail configuration helps improve email reputation and inbox placement. -
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.
