Link SMTP — Documentation

Everything you need to set up and run Link SMTP and Link SMTP Pro. Choose a topic:

What SMTP Overrider does

WordPress sends email through PHP's built-in mail() function, which most hosts handle poorly or block outright. The result: contact-form replies, WooCommerce receipts, password resets and admin notices quietly fail or land in spam, and you usually do not find out until a customer says they never got the email.

SMTP Overrider fixes this. It overrides the broken default mailer and routes every WordPress and WooCommerce email through a real, authenticated connection so your messages actually arrive. It works on every host - SiteGround, GoDaddy, Bluehost, Hostinger, Cloudways, Kinsta and more - and with any mailbox. Your email always sends from your own account; nothing routes through our servers.

There are two editions: the free SMTP Overrider plugin, and the paid Full Version add-on which removes the free sending cap and adds multiple accounts, a full email log with analytics, scheduled sending with retry, and failure alerts.

Requirements & install

WordPress 5.8+ and PHP 7.4+. You can send through any mailbox you control (your host's mail, Gmail/Workspace, Microsoft 365, or a service like Brevo, SendGrid, Amazon SES, Mailgun, Postmark).

Install the free plugin

  1. In wp-admin go to Plugins → Add New → Upload Plugin and upload the SMTP Overrider zip (or install from the WordPress.org directory), then Activate.
  2. If your host blocks the uploader, use your hosting File Manager to extract the plugin into wp-content/plugins/ instead, then activate.

Install the Full Version (optional)

The Full Version is a separate add-on that installs alongside the free plugin - it does not replace it. Install and activate SMTP Overrider (free) first, then install SMTP Overrider Full Version, then activate your license under its License tab. The free plugin holds the sending engine and all your settings; the Full Version simply unlocks extra features, so never run it without the free plugin active.

Quick start

The fastest path to working email is a provider preset:

  1. Open SMTP Overrider → Manual SMTP.
  2. Pick your provider from the preset dropdown - host, port and encryption fill in automatically.
  3. Enter your username (usually your full email address) and password. Where the provider supports it, use an app password rather than your main account password.
  4. Click Save, then go to the Settings tab and use Send a test email.

If the test arrives, you are done - every WordPress and WooCommerce email now sends reliably from your mailbox. If it fails, the Email Log shows the exact error to act on (see Troubleshooting).

Every tab and setting

Connect (1-click)

Lists your connected sending accounts and lets you mark one as active. If you have connected Google or Office 365, or added a manual SMTP account, it appears here with an Active badge on the one in use.

Manual SMTP

The simplest path. Choose a provider preset (or enter a custom host), then fill host, port, encryption (TLS/SSL/none), username and password. Presets auto-fill the technical fields so you do not have to look them up.

Settings

From name and From email set what recipients see; for Gmail/Office these should match (or be an alias of) the connected mailbox. Force from makes every email use these addresses, overriding other plugins. This tab also has the Send a test email box.

Email Log

A record of what was sent, each row marked sent or error. When something fails, the error text here tells you exactly why - the single most useful place when diagnosing delivery.

Your Own App (optional, advanced)

A step-by-step wizard for connecting Google (Gmail API) or Office 365 (Microsoft Graph) via OAuth, including the exact redirect URI to paste into your provider. Optional - most people are faster with a preset and an app password.

License (Full Version)

Where you paste and activate your license key to unlock the Full Version features. Shows current status; if a license is removed or lapses, the site reverts to the free feature set (your settings are preserved).

Analytics & Scheduled (Full Version)

Analytics summarises delivery over time; Scheduled manages queued sends with retry. These appear when the Full Version is active.

Connecting Google & Office 365

This is an optional advanced path for sending via OAuth instead of a password. The free version lets you register your own provider app (the in-plugin Your Own App wizard walks you through it and shows the exact redirect URI to paste). Once connected, mail sends from your account via the Gmail API or Microsoft Graph; nothing routes through our servers.

Google / Gmail

  1. In Google Cloud Console, create or pick a project and enable the Gmail API.
  2. Configure the OAuth consent screen (External) and add yourself as a test user.
  3. Create an OAuth client ID (Web application) and add the redirect URI the plugin shows.
  4. Paste the Client ID and Secret on the Connect tab and click Connect Google.

Office 365 / Outlook

  1. In Microsoft Entra, create an App registration (any directory + personal accounts).
  2. Set the Web redirect URI the plugin shows.
  3. Create a client secret and add Microsoft Graph delegated permissions Mail.Send, offline_access, User.Read.
  4. Paste the Client ID and Secret on the Connect tab and click Connect Office 365.

Note: a truly zero-setup, hosted one-click connection (where you just click Allow with no app to register) is on our roadmap and depends on provider verification. Until then, a provider preset with an app password is the quickest route.

Licensing & tiers

Free fixes WordPress and WooCommerce email on any host, with provider presets, optional Google/Office connect, a recent email log, and a fair-use cap of 300 emails per calendar month (shown at the top of the settings screen; resets on the 1st). The cap exists only so you can try the plugin at no cost - your mail sends from your own mailbox and never costs anything.

Full Version removes the cap and adds unlimited sending, multiple connected accounts, a full email log (up to 500 rows) with analytics, scheduled sending with retry, failure alerts, more provider presets, and MX auto-detect. It is a one-time purchase for unlimited sites with lifetime updates.

Activating a license

Install the Full Version add-on alongside the free plugin, open its License tab, paste your key and activate. Buyers who download the pre-stamped copy from their account are licensed automatically - no pasting needed.

Moving a license / what happens if it lapses

Your license can be moved to another site. If a license is deactivated or a subscription lapses, the plugin simply reverts to the free feature set on its next check - your accounts, settings and logs stay intact, so re-activating restores the full features instantly.

Automatic updates

SMTP Overrider checks our update service and shows new versions on your Dashboard → Updates screen, just like any other plugin, with a one-click Update button. The free plugin updates without a key; the Full Version updates against your license.

To check immediately rather than waiting for the daily check, go to Dashboard → Updates and click Check again. Note that the first version containing the updater must be installed once before automatic update notices can appear for later versions.

Troubleshooting

  • Test email fails or times out ('gateway timed out'): your host is almost certainly blocking the SMTP port. On the Manual SMTP tab, switch the port to 587 with TLS (or 465 with SSL) and save, then test again. If both are blocked, use a provider that sends over HTTPS (such as an API-based service). This is the most common fix on shared hosting.
  • Emails still not sending: open the Email Log tab and read the most recent error - it names the exact problem (authentication, connection refused, no active account, etc.).
  • Authentication failed: double-check the username (usually the full email address) and use an app password where the provider supports it, not your main account password.
  • No refresh token (Google): remove the app under your Google Account → Security → Third-party access, then reconnect.
  • Office 365 blocked: ensure Mail.Send and offline_access permissions are granted on the app registration.
  • Hitting the free 300/month cap: upgrade to the Full Version for unlimited sending.
  • Install error ('does not have a valid header') or a half-installed plugin: use your hosting File Manager to extract the plugin into wp-content/plugins/ and activate from there.

Frequently asked questions

Why are my WordPress emails not sending or going to spam?

Because WordPress uses PHP's mail() function by default, which most hosts handle poorly or block. SMTP Overrider replaces it with a proper authenticated connection so your mail is delivered reliably.

Does this work on my host?

Yes - it is designed to work on every host, including ones that block common mail ports or disable mail(). If one method is restricted, you can switch to another that works.

Does my email go through your servers?

No. Email sends directly from your own mailbox - via your SMTP server, or optionally the Gmail API or Microsoft Graph. Nothing routes through us.

Do I have to set up a Google or Microsoft app?

No. The simplest path is a provider preset with a username and app password - no app setup at all. OAuth connect is optional.

Is my password stored safely?

Yes. Passwords and tokens are encrypted at rest using AES-256-CBC keyed off your site's security salts.

Support

Need a hand? Email peter@qualityleadgen.ca with your site URL, what you are trying to send, and the latest line from the Email Log tab - that error usually points straight at the fix.