Documentation - WP All SMTP | Setup Guides for Every Provider

Custom SMTP Setup

Connect to any SMTP server by entering your host, port, and authentication details.

Required Settings

Field	Value
SMTP Host	`smtp.yourprovider.com`
Encryption	`TLS` (recommended) or `SSL`
Port	`587` (TLS) or `465` (SSL)
Authentication	Yes
Username	Your email/username
Password	Your SMTP password or app password

Step-by-step Guide

Navigate to WP All SMTP → Settings in your WordPress admin.
Under Mailer, select Other SMTP.
Enter your SMTP host, port, and encryption type.
Enable authentication and enter your username and password.
Set your From Email and From Name.
Click Save Settings.
Go to the Test Email tab and send a test to verify.

Tip: If you're using Gmail, we recommend using the dedicated Gmail provider option instead of custom SMTP for better compatibility.

Gmail / Google Workspace Setup

Send emails using your Gmail or Google Workspace account with SMTP authentication.

Gmail SMTP Settings

Field	Value
SMTP Host	`smtp.gmail.com`
Encryption	`TLS`
Port	`587`
Username	Your full Gmail address
Password	App password (not your normal password)

Creating a Gmail App Password

Go to your Google Account → Security.
Enable 2-Step Verification if not already enabled.
Under "Signing in to Google", click App passwords.
Select Mail as the app, Other as the device, name it "WP All SMTP".
Click Generate and copy the 16-character password.
Use this app password in the plugin settings.

Important: Gmail has a daily sending limit of 500 emails (or 2,000 for Google Workspace). For high-volume sites, consider using SendGrid or Amazon SES.

SendGrid Setup

SendGrid is a popular cloud-based email service offering a free tier of 100 emails/day.

Create a free account at sendgrid.com.
Navigate to Settings → API Keys.
Click Create API Key, choose "Full Access" or "Restricted Access" (with Mail Send permissions).
Copy the generated API key.
In WP All SMTP, select SendGrid as your mailer.
Paste your API key in the API Key field.
Set your From Email (must be a verified sender in SendGrid).
Click Save Settings and send a test email.

Sender Authentication

SendGrid requires you to verify your sender identity. Go to Settings → Sender Authentication in your SendGrid dashboard to verify your domain or single sender.

Mailgun Setup

Mailgun is a powerful email API service. Free tier includes 5,000 emails for the first 3 months.

Sign up at mailgun.com.
Add and verify your sending domain.
Go to API Security and create a new API key.
In WP All SMTP, select Mailgun as your mailer.
Enter your API Key and Domain Name.
Select your Region (US or EU).
Save and test.

Brevo (formerly Sendinblue) Setup

Brevo offers 300 free emails per day, making it perfect for small to medium WordPress sites.

Create a free account at brevo.com.
Go to SMTP & API in your account settings.
Copy your API Key.
In WP All SMTP, select Brevo as your mailer.
Paste your API key.
Save and test.

Amazon SES Setup

Amazon Simple Email Service (SES) is highly scalable and cost-effective at $0.10 per 1,000 emails.

Sign in to the AWS Console.
Navigate to Amazon SES service.
Verify your sending domain or email address.
Create IAM credentials with SES send permissions.
Note your Access Key ID and Secret Access Key.
In WP All SMTP, select Amazon SES.
Enter your Access Key, Secret Key, and select your SES Region.
Save and test.

Sandbox Mode: New SES accounts start in sandbox mode. You'll need to request production access to send emails to unverified addresses.

Postmark Setup

Postmark is known for the fastest email delivery times. First 100 emails free to test.

Sign up at postmarkapp.com.
Create a new Server and get your Server API Token.
Verify your sending domain with the provided DNS records.
In WP All SMTP, select Postmark.
Enter your Server API Token.
Save and test.

SparkPost Setup

SparkPost offers a free tier with 500 emails/month and excellent analytics.

Create an account at sparkpost.com.
Add and verify your sending domain.
Generate an API key with Transmissions: Read/Write permission.
In WP All SMTP, select SparkPost.
Enter your API Key and select your region (US or EU).
Save and test.

Outlook / Microsoft 365 Setup

Premium Provider

Connect your Outlook.com or Microsoft 365 business account to send WordPress emails via Microsoft's enterprise-grade SMTP servers using secure Azure AD app authentication.

Plugin SMTP Settings

Setting	Value
SMTP Host	`smtp.office365.com`
Port	`587`
Encryption	`TLS (STARTTLS)`
Authentication	`Application (Client) ID + Client Secret`

Step-by-Step Setup Guide

1 Register an Azure AD Application

Go to the Azure Portal → App Registrations.
Click "+ New registration".
Enter a name (e.g., "WordPress SMTP").
For Supported account types, choose the option that matches your organization (single tenant for M365 business, or "Personal Microsoft accounts" for Outlook.com).
Leave Redirect URI blank for now — click Register.

2 Copy the Application (Client) ID

After registration, you'll land on the app's Overview page.
Copy the Application (client) ID — this is your client_id for the plugin.
It looks like: a1b2c3d4-e5f6-7890-abcd-ef1234567890

3 Create a Client Secret

In the left sidebar, go to Certificates & secrets.
Click "+ New client secret".
Add a description (e.g., "WP SMTP Secret") and choose an expiry period.
Click Add. Immediately copy the secret Value — it won't be shown again.
Paste this value as the client_secret in the plugin.

Important: Copy the secret value immediately. Once you navigate away, you cannot retrieve it — you'll need to create a new one.

4 Configure API Permissions (Optional)

Go to API permissions in the sidebar.
Click "+ Add a permission" → Microsoft Graph.
Choose Delegated permissions, then search for and add SMTP.Send.
Click Grant admin consent if available (admin accounts only).

5 Configure the Plugin

In WordPress admin, go to WP All SMTP → Settings.
Select Outlook / 365 as your mailer.
Enter the Application (Client) ID you copied in Step 2.
Enter the Client Secret you copied in Step 3.
Set From Email to your Microsoft 365 or Outlook.com email address.
Click Save Settings.

6 Test Your Configuration

Go to WP All SMTP → Test Email.
Enter a recipient email and click Send Test Email.
You can also click Test Connection to verify the SMTP connection without sending.
Check the Email Log tab to confirm the test was logged.

Troubleshooting

"Authentication unsuccessful" error

Ensure SMTP authentication is enabled for the mailbox in Microsoft 365 admin center: Users → Active users → Mail → Manage email apps → check "Authenticated SMTP".

Client Secret expired

Azure AD client secrets have an expiry date. Go back to Azure Portal → Certificates & secrets and create a new one, then update the plugin settings.

From email doesn't match

Microsoft requires the From Email in the plugin to match the authenticated Microsoft 365 mailbox address exactly.

Resend Setup

Resend is a modern email API built for developers. Free tier includes 3,000 emails/month.

Sign up at resend.com.
Add and verify your domain in the Resend dashboard.
Go to API Keys and create a new key.
In WP All SMTP, select Resend.
Enter your API Key.
Save and test.

Email Logging

WP All SMTP automatically logs every email sent from your WordPress site.

Viewing Logs

Navigate to WP All SMTP → Email Log to see all sent emails with:

Recipient address and subject line
Delivery status (Sent/Failed) with error details
Date and time of each email
Search and filter capabilities

Exporting Logs

Click the Export CSV button at the top of the log page to download your complete email history as a CSV file.

Resending Emails

Click the Resend button next to any log entry to resend that email immediately.

Troubleshooting

Common issues and their solutions.

Test email not arriving

Check your spam/junk folder
Verify your From Email is a valid, existing address
Use the Connection Test button to check server connectivity
Make sure your email provider account is active and verified

Authentication errors

Double-check your API key or SMTP password
For Gmail, make sure you're using an App Password, not your regular password
Ensure your API key has the correct permissions (mail send)

Connection timeout

Your hosting provider may be blocking outbound SMTP connections
Try switching between port 587 (TLS) and port 465 (SSL)
Contact your hosting provider to allow outbound connections on the required port
Consider using an API-based provider (SendGrid, Mailgun) instead of SMTP

Emails going to spam

Set up SPF, DKIM, and DMARC DNS records for your domain
Use a verified domain with your email provider
Ensure your From Email matches your verified domain
Don't use free email addresses (gmail.com, yahoo.com) as your From address

Setup Guides & Documentation

Quick Start

Install Plugin

Configure Provider

Test & Go Live

Provider Guides

General

Custom SMTP Setup

Required Settings

Step-by-step Guide

Gmail / Google Workspace Setup

Gmail SMTP Settings

Creating a Gmail App Password

SendGrid Setup

Sender Authentication

Mailgun Setup

Brevo (formerly Sendinblue) Setup

Amazon SES Setup

Postmark Setup

SparkPost Setup

Outlook / Microsoft 365 Setup

Plugin SMTP Settings

Step-by-Step Setup Guide

1 Register an Azure AD Application

2 Copy the Application (Client) ID

3 Create a Client Secret

4 Configure API Permissions (Optional)

5 Configure the Plugin

6 Test Your Configuration

Troubleshooting

Resend Setup

Email Logging

Viewing Logs

Exporting Logs

Resending Emails

Troubleshooting

Test email not arriving

Authentication errors

Connection timeout

Emails going to spam

Need more help?