You’ve just launched a new lead magnet. Subscribers are signing up. You’re excited to nurture them through your email sequence.
Then you check your dashboard a week later and realize something’s wrong — open rates are at zero, and confused users are emailing you directly asking why they never received their download link.
This is one of the most frustrating issues WordPress site owners face. The problem isn’t your content or your offer.
It’s that WordPress, by default, sends emails in a way that modern email providers don’t trust.
Without proper configuration, your contact form notifications, password resets, and WooCommerce confirmations will end up in spam folders or disappear entirely.
Learning how to configure WordPress SMTP to stop email delivery issues is essential for any serious website owner.
Below, we’ll show you exactly why the default setup fails, what SMTP does differently, and how to set it up in under 10 minutes.
How to Configure WordPress SMTP to Stop Email Delivery Issues?

Why WordPress Default Email Delivery Fails?
WordPress uses a built-in function called wp_mail() to send emails.
This function relies on PHP’s basic mail() function, which is fine for simple notifications but lacks the authentication that email providers like Gmail and Outlook require.
Here’s the problem: when an email arrives without proper authentication, receiving servers have no way to verify it actually came from your domain.
It looks exactly like the kind of spoofed message that spammers send. Gmail and other providers flag these messages automatically.
Most hosting servers aren’t optimized for email delivery either. They’re built to serve web pages quickly, not to handle complex email protocols.
Many hosts block common SMTP ports or throttle email traffic to prevent abuse, which means your messages get delayed or blocked entirely.
Postman Is Not Configured and Is Mimicking Out of the Box WordPress Email Delivery
If you’ve ever seen the error message “Postman is not configured and is mimicking out-of-the-box WordPress email delivery,” you’re experiencing exactly this problem.
Postman SMTP plugin is letting you know it’s using WordPress’s unreliable default method instead of a properly configured SMTP connection.
This happens when the plugin is installed but hasn’t been set up with actual SMTP credentials. It’s a clear sign you need to complete the configuration process.
What SMTP Does Differently?
SMTP (Simple Mail Transfer Protocol) is the standard way emails are sent across the Internet.
Unlike WordPress’s default method, SMTP requires authentication before sending any message.
When you configure WordPress SMTP, you’re connecting your site to a mail server using secure credentials.
This connection is encrypted with SSL or TLS, which protects your emails during transmission and proves to receiving servers that you’re legitimate.
| Method | Authentication | Encryption | Deliverability |
|---|---|---|---|
| Default wp_mail() | None | None | Poor (often blocked) |
| SMTP Configuration | Username/Password | SSL/TLS | High (trusted sender) |
SMTP works with all major email services, including Gmail, Outlook, Office 365, SendGrid, Mailgun, and Amazon SES. Each service provides the credentials you need to send authenticated emails through your WordPress site.
How to Install WP Mail SMTP Plugin?
The easiest way to configure WordPress SMTP is using a dedicated plugin. WP Mail SMTP is one of the most popular options, with over 3 million active installations.
Go to your WordPress dashboard and navigate to Plugins → Add New. Search for “WP Mail SMTP” and click Install Now, then Activate.
Once activated, you’ll see a setup wizard. This walks you through the basic configuration, but you’ll need to choose which SMTP service you want to use.
Choosing Your SMTP Service
You have several options:
- Gmail SMTP – Free for low-volume sending (up to 500 emails per day). Good for small sites and testing.
- Office 365 SMTP – Reliable option if you already use Microsoft 365 for business email.
- SendGrid – Professional transactional email service with a free tier (100 emails per day).
- Mailgun – Another solid option with generous free limits.
- Amazon SES – Extremely affordable for high-volume sending.
For most small to medium sites, Gmail SMTP setup for WordPress is the quickest way to get started.
Gmail SMTP Setup WordPress Configuration
Here’s how to set up Gmail SMTP in WordPress step by step:
Enable Two-Factor Authentication and Create App Password
Gmail requires an app-specific password for SMTP access. You can’t use your regular Gmail password.
Go to your Google Account settings, navigate to Security, and enable 2-Step Verification if you haven’t already.
Once that’s active, go back to Security and find “App passwords.” Generate a new app password for “Mail” on “Other device.”
Copy this 16-character password. You’ll need it in the next step.
Configure WP Mail SMTP Settings
In your WordPress dashboard, go to WP Mail SMTP → Settings.
Choose Gmail as your mailer. Enter the following details:
- From Email: Your Gmail address
- From Name: Your name or business name
- SMTP Host: smtp.gmail.com
- Encryption: Use TLS
- SMTP Port: 587
- SMTP Username: Your full Gmail address
- SMTP Password: The 16-character app password you just created
Save your settings.
Office 365 SMTP WordPress Plugin Setup
If you’re using Microsoft 365 for business email, the configuration is slightly different.
In WP Mail SMTP settings, choose “Other SMTP” and enter:
- SMTP Host: smtp.office365.com
- Encryption: TLS
- SMTP Port: 587
- SMTP Username: Your full Office 365 email address
- SMTP Password: Your Office 365 password (or app password if you have 2FA enabled)
Microsoft’s servers are strict about sender authentication, so make sure your “From Email” matches your Office 365 email exactly.
Testing Your SMTP Configuration
After you configure WordPress SMTP, you need to verify it’s working correctly.
Most SMTP plugins include a test email feature. In WP Mail SMTP, go to Settings → Email Test. Enter your email address and click Send Email.
Check your inbox (and spam folder) for the test message. If it arrives, your configuration is working.
WP Mail SMTP Email Log
One of the most valuable features in WP Mail SMTP Pro is the email log. This tracks every email your WordPress site attempts to send, showing you which ones succeeded and which failed.
If you’re troubleshooting delivery issues, the email log shows you the exact error messages from the SMTP server. This makes it much easier to identify problems like incorrect credentials or blocked ports.
How to Send Email in WordPress Without a Plugin?
If you prefer not to use a plugin, you can configure WordPress SMTP directly in your wp-config.php file or functions.php file. However, this approach requires writing code and manually handling credentials.
Here’s a basic example using PHPMailer (which WordPress includes):
add_action('phpmailer_init', 'configure_smtp');
function configure_smtp($phpmailer) {
$phpmailer->isSMTP();
$phpmailer->Host = 'smtp.gmail.com';
$phpmailer->SMTPAuth = true;
$phpmailer->Port = 587;
$phpmailer->Username = 'your-email@gmail.com';
$phpmailer->Password = 'your-app-password';
$phpmailer->SMTPSecure = 'tls';
}
This works, but it’s less secure than using a plugin because your credentials are stored in plain text in your theme files. Plugins encrypt this data and provide better security.
WordPress Send Email With Attachment Programmatically
If you need to send emails with attachments programmatically, the wp_mail() function supports this once SMTP is configured.
Here’s the syntax:
$to = 'recipient@example.com';
$subject = 'Your download is ready';
$message = 'Thanks for subscribing. Your PDF is attached.';
$headers = array('Content-Type: text/html; charset=UTF-8');
$attachments = array('/path/to/file.pdf');
wp_mail($to, $subject, $message, $headers, $attachments);
Once you’ve configured SMTP properly, this function will send authenticated emails with your attachments through your chosen mail server instead of the unreliable default method.
Mailtrap WordPress Testing
Before you start sending emails to real subscribers, it’s smart to test your setup in a safe environment.
Mailtrap is a tool that catches all emails sent from your WordPress site without actually delivering them.
This lets you preview exactly how your emails look, check formatting, verify links, and ensure everything works correctly before going live.
To use Mailtrap with WordPress, sign up for a free account, get your SMTP credentials from the Mailtrap dashboard, and enter them in your WP Mail SMTP settings just like you would with Gmail or any other provider.
Once you’re confident everything works, switch back to your production SMTP credentials.
Common SMTP Configuration Problems and Fixes
Even when you follow the steps correctly, you might run into issues. Here are the most common problems:
- Wrong Port or Encryption Type
If your test email fails, double-check that you’re using the correct port and encryption combination. For most services, port 587 with TLS is standard. Some services use port 465 with SSL instead.
- Hosting Provider Blocking SMTP Ports
Some shared hosting providers block outbound SMTP connections to prevent spam. If your configuration looks correct but emails won’t send, contact your host and ask if they block ports 587 or 465.
- Authentication Errors
If you see authentication failed errors, verify that your username and password are correct. Remember that Gmail and Office 365 require app-specific passwords when 2FA is enabled.
- DNS Records Not Configured
Services like SendGrid and Mailgun require you to add SPF and DKIM records to your domain’s DNS settings. These verify you own the domain and improve deliverability. Check your email service’s documentation for the exact records you need to add.
SMTP Service Comparison
| Service | Free Tier | Best For | Setup Difficulty |
|---|---|---|---|
| Gmail | 500 emails/day | Small sites, testing | Easy |
| Office 365 | Included with subscription | Business users | Easy |
| SendGrid | 100 emails/day | Transactional emails | Moderate |
| Mailgun | 5,000 emails/month (3 months) | Developers | Moderate |
| Amazon SES | $0.10 per 1,000 emails | High volume | Advanced |
Frequently Asked Questions
- Do I need SMTP if my hosting provider provides email?
Yes. Even if your host offers email addresses, they’re usually not optimized for sending automated emails from WordPress. SMTP services are specifically designed for transactional email delivery and have much better deliverability rates.
- Will SMTP work with WooCommerce order emails?
Absolutely. Once you configure WordPress SMTP, all emails sent by WordPress — including WooCommerce order confirmations, shipping notifications, and password resets — will use your SMTP connection.
- Can I use a free Gmail account for business emails?
Technically, yes, but it’s not ideal. Gmail’s free tier limits you to 500 emails per day, and some subscribers might see your @gmail.com address as less professional. Consider using a business email address with your domain name instead.
- What happens if I exceed my SMTP service’s daily limit?
Your emails will fail to send until the limit resets (usually after 24 hours). Most SMTP plugins will log these failures. If you regularly hit limits, you’ll need to upgrade to a paid plan or switch to a service with higher limits.
- How do I know if my SMTP configuration is working correctly?
Send a test email through your SMTP plugin, then check the email headers in your inbox. Look for “spf=pass” and “dkim=pass” in the authentication results. This confirms your emails are being sent and authenticated correctly.
Final Thoughts on WordPress SMTP Configuration
Email delivery isn’t something you can ignore if you’re serious about your WordPress site.
Whether you’re running an eCommerce store, a membership site, or a simple blog with a contact form, reliable email delivery is essential.
Taking 10 minutes to configure WordPress SMTP to stop email delivery issues will save you countless hours of frustration and lost revenue from missed order confirmations or contact form submissions that never reach you.
Start with a simple Gmail SMTP setup if you’re just getting started, then consider upgrading to a dedicated transactional email service as your site grows.
The important thing is to stop relying on WordPress’s default email function and start using a proper SMTP connection today.
Also Check: