WooCommerce · Info
WooCommerce SMTP Settings Explained: What Each Option Does

Short answer
WooCommerce has no SMTP screen of its own. You set the sender name and address in WooCommerce email settings, then an SMTP plugin supplies the host, port, encryption and login, or an API key, so store emails go through an authenticated mail service instead of server PHP mail.
Key takeaways
- WooCommerce sends email through wp_mail(), which an SMTP plugin reroutes.
- Set the WooCommerce From address to an address your mail service allows.
- Use port 587 with TLS or 465 with SSL; avoid port 25.
- API mailers avoid blocked ports and suit busy stores.
- SPF, DKIM and DMARC records keep order emails out of spam.
What are WooCommerce SMTP settings?
WooCommerce SMTP settings are the mail server details, such as host, port, encryption, username and password, that an SMTP plugin uses to send store emails through a real mail service instead of the web server.
WooCommerce itself has no SMTP screen. Its email settings, under WooCommerce > Settings > Emails, control which emails are sent, the sender name and address, and the templates. The actual delivery is handed to WordPress through the wp_mail() function.
By default, wp_mail() uses PHP mail on your server. Many inboxes distrust that, so order confirmations land in spam or vanish. An SMTP plugin, such as WP Mail SMTP, reroutes wp_mail() through an authenticated mail service.
So WooCommerce SMTP settings really means two sets of options working together: WooCommerce's sender settings and the SMTP plugin's connection settings.
Which WooCommerce email settings matter for SMTP?
The From name and From address in WooCommerce's email sender options matter most, because they must match an address your SMTP service is allowed to send from.
Under WooCommerce > Settings > Emails, scroll to the sender options. You will see:
- From name: the name customers see, usually your store name
- From address: the email address orders are sent from
Use an address on your own domain, such as [email protected]. If this address differs from the account your SMTP service authenticates with, some services reject the email or rewrite the sender.
The same screen lists each email, such as new order, processing order and completed order, with its own on or off switch and recipient. Our guide to WooCommerce email settings explains every one.
What does each SMTP setting mean?
Each SMTP setting tells WordPress how to connect and log in to the mail server: where it is, which port and encryption to use, and which account to authenticate with.
| Setting | What it means | Typical value |
|---|---|---|
| SMTP host | The mail server address | smtp.yourprovider.com |
| Encryption | How the connection is secured | TLS or SSL |
| Port | The server port for that encryption | 587 for TLS, 465 for SSL |
| Auto TLS | Upgrades to TLS when the server supports it | On |
| Authentication | Whether a login is required | On |
| Username | The mailbox or API user | Often the full email address |
| Password | The mailbox password or app password | Stored securely |
| From email | The sender address used for all mail | Address on your domain |
| Force From email | Overrides the From address set by plugins | On, in most stores |
| Return path | Where bounce notices go | Match the From email |
Your email provider's help pages list the exact host and ports. Never guess these values.
Which port and encryption should you choose?
Use port 587 with TLS for most providers, or port 465 with SSL if your provider recommends it; avoid port 25, which many hosts block.
Port 587 starts unencrypted and upgrades with STARTTLS. Port 465 uses an encrypted connection from the start, and both are secure when set up correctly.
The IETF standard RFC 8314 describes the use of implicit TLS for mail submission.
If the connection times out, your host may block outgoing SMTP ports. Ask your host, or switch to an API-based mailer that sends over HTTPS instead.
Some hosts also limit how many emails an account can send per hour. A store with many orders, plus newsletters, can hit that ceiling quickly, so check your provider plan limits before a busy sale period.
What is the difference between SMTP and an API mailer?
Plain SMTP logs into a mail server with a username and password, while an API mailer sends through a provider's web API with an API key, which is often faster and avoids blocked ports.
SMTP plugins usually offer both. The Other SMTP option needs host, port and login details. Provider options, such as SendGrid, Mailgun, Brevo, Amazon SES or Postmark, use an API key instead.
API mailers suit busy stores because they handle large volumes, give delivery logs, and work even when the host blocks SMTP ports. They do need a provider account and domain verification.
For Gmail or Google Workspace, use the dedicated Google option or an app password with two-step verification, rather than your normal password.
What does Force From Email do?
Force From Email makes every email use the From address set in the SMTP plugin, ignoring what WooCommerce or other plugins request, which keeps the sender consistent and accepted by your mail service.
This matters because WooCommerce, form plugins and WordPress core may each set different From addresses. Your mail service may only allow one. Forcing the From address prevents rejected messages.
The trade-off is that the WooCommerce From address setting has no effect while forcing is on. Set both to the same address to avoid confusion. If the setting seems ignored, see WP Mail SMTP force from email not working.
Why do DNS records matter for SMTP?
SPF, DKIM and DMARC records prove your mail service may send for your domain, so inboxes trust your order emails instead of filtering them as spam.
Your SMTP or API provider gives you the records to add at your DNS host. Without them, even correctly sent emails can land in spam.
- SPF lists services allowed to send for your domain
- DKIM signs each message so it cannot be altered
- DMARC tells inboxes what to do when checks fail
Our guide on how to set up SPF, DKIM and DMARC walks through each record.
How do you test WooCommerce SMTP settings?
Send a test email from the SMTP plugin, place a test order, then check the inbox, spam folder and the plugin's email log for errors.
A plugin test email checks the connection. A test order checks WooCommerce's own emails, which use templates and the store's sender details.
Check these results:
- The test email arrives in the inbox, not spam.
- A new order email reaches the admin recipient.
- A processing order email reaches the customer.
- The email log shows sent, with no errors.
Our guide on how to test WP Mail SMTP covers the test tools in detail.
What are common SMTP errors in WooCommerce?
The most common errors are failed authentication, connection timeouts and rejected sender addresses, each pointing to a different setting.
| Error | Likely cause | Fix |
|---|---|---|
| Could not authenticate | Wrong username, password or app password | Re-enter credentials or create an app password |
| Connection timed out | Host blocks the SMTP port | Try another port or an API mailer |
| Sender address rejected | From email not allowed by the service | Use a verified address and Force From Email |
| Emails sent but in spam | Missing SPF, DKIM or DMARC | Add DNS records from your provider |
For authentication problems, see fix SMTP could not authenticate.
If emails still fail after SMTP is set up, our full guide to WooCommerce emails not sending covers the remaining causes, such as disabled emails and stuck scheduled actions.
Frequently asked questions
Does WooCommerce have built-in SMTP settings?
No. WooCommerce controls which emails are sent and the sender details, but delivery goes through WordPress. To use SMTP, install an SMTP plugin and enter your mail service details there.
What SMTP port should WooCommerce use?
Port 587 with TLS works for most providers, and port 465 with SSL is the common alternative. Check your provider's help pages, and avoid port 25, which many web hosts block for outgoing mail.
Can I use Gmail for WooCommerce emails?
You can, but use the dedicated Google option in your SMTP plugin or an app password with two-step verification. Consumer Gmail has sending limits, so busy stores usually choose a transactional email service.
Why are WooCommerce emails going to spam after setting up SMTP?
SMTP fixes the connection, but inboxes also check your domain's SPF, DKIM and DMARC records. Add the records your mail provider supplies and use a From address on your own domain.
Should I turn on Force From Email?
In most stores, yes. It keeps every email on one approved sender address, which prevents rejections. Set the WooCommerce From address to the same value so the settings do not appear to conflict.
Sources
- wp_mail() WordPress Developer Resources
- WP Mail SMTP WordPress.org
- RFC 8314: Cleartext Considered Obsolete IETF
- Sign in with app passwords Google Account Help
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


