how to send wordpress emails with gmail

How To Use Gmail SMTP in WordPress To Send Emails (2 Options)

Editorial Note: We may earn a commission when you visit links on our website.

Are you looking for a simple and straightforward way to send WordPress emails using the Gmail SMTP?

Sending WordPress emails through Gmail SMTP is a great idea to improve deliverability and avoid emails going to the spam folder.

In this guide, we’ll walk you through the steps on how to configure the Google Workspace / Gmail mailer in WP Mail SMTP via 2 different methods.

How Do I Connect My WordPress Email to Gmail?

WP Mail SMTP makes it incredibly easy to configure a Google Workspace / Gmail SMTP via 2 different methods:

If you are using the WP Mail SMTP Pro version, we highly recommend that you use the One-Click Setup process because:

  • You don’t need to generate an app password in your Google account.
  • You don’t need to share passwords in WordPress to improve email delivery.

With the One-Click Setup feature, you can fix your website’s email delivery problems quickly and safely, without having to do any complicated setup.

wp mail smtp statistics

WP Mail SMTP fixes all email deliverability issues for your WordPress website and will also work for you if:

  • SMTP (Simple Mail Transfer Protocol) ports are blocked, which is a common problem on some WordPress hosting providers and Amazon EC2.
  • You’re using localhost and you want to send outgoing emails from your site through a simple setup process and SMTP port.
  • Your hosting provider isn’t configured to use the PHP mail function for some other reason.

We’ve got more details in our WP Mail SMTP review. It’s one of the best G-Suite plugins for WordPress!

Let’s go ahead and take a look at how to set up WP Mail SMTP to send emails through the Gmail SMTP.

How to Set Up WP Mail SMTP With Gmail

Setting up WP Mail SMTP with Gmail email server is easy. We recommend keeping this guide open in a tab so you can follow the steps as you work through it.

If you’re not sure that you want to tackle this yourself, keep in mind that WP Mail SMTP customers have the option to purchase White Glove Setup.

For a one-time fee, the plugin support team will set up your emails using SendLayer, Mailgun, or

Method #1: Using the One-Click-Setup Feature

With the one-click setup option in WP Mail SMTP Pro, it’s now easy to connect your WordPress site to Google’s email service and use the Gmail API to send emails from your site right away.

Step 1: Install the WP Mail SMTP Pro Plugin

Since the One-Click-Setup feature can only be used with the WP Mail SMTP Pro license, make sure to upgrade your account.

the wp mail smtp homepage

Once done, get ready to install the WP Mail SMTP plugin. For step-by-step instructions, you can check out this guide on how to install a WordPress plugin.

Step 2: Select Google / Gmail As Your Mailer

We’ll now connect WP Mail SMTP with Gmail. To do this, go to WP Mail SMTP » Settings and click on the General tab.

wp mail smtp settings

Now, scroll down from the Primary Connection section until you reach the Mailer heading. Then, choose the Google / Gmail option.

select google mailer

For this mailer to work, your site needs to be set up with SSL (https). To set it up, check out this guide on adding SSL and HTTPS in WordPress.

When you choose the mailer for your WordPress site, you will see a new section called Google / Gmail with more authorization options.

gmail mailer settings

There should now be two choices available: use the One-Click Setup process or generate your Client ID and Client Secret.

Because we want to keep things simple, let’s move the toggle to the ON position for the One-Click Setup option.

one click setup gmail mailer

After turning on One-Click Setup, all you have to do is click the Save Settings button at the bottom of the page.

gmail mailer save settings

Just be patient for a moment and the page will reload, allowing you to access the authorization settings.

Step 3: Authorize Your Google Account with WP Mail SMTP

After the page reloads, scroll down until you find the Authentication section. From there, click on the Sign in with Google button.

sign in with google button

You’ll now be redirected to the Gmail login screen. Enter the details for the Gmail account you want to use for sending emails in WordPress.

Once done, you’ll be asked to provide WP Mail SMTP authorization to your Gmail account. Click on the Allow button to proceed.

allow gmail mailer permission

Once the authorization process is complete, you’ll be redirected to the WP Mail SMTP settings page, where you’ll be able to see a success message.

gmail mailer success message

Upon scrolling down a bit, you’ll also notice that the Gmail account you set up can be seen in the Authorization section.

gmail mailer authorized account

And there you have it! You’ve successfully connected your Gmail account with WP Mail SMTP via the One-Click-Setup method!

Method #2: Using the  Manual Gmail API Connection

If you are using WP Mail SMTP Lite (the free version of the plugin), you can still use the Gmail SMTP to send all WordPress emails. This process requires that you use your Google account to create a web application.

Step 1: Create a Web App in Your Google Account

After installing the WP Mail SMTP Lite plugin and selecting Google / Gmail as your mailer, WP Mail SMTP will ask you for 2 things: Client Secret and Client ID.

gmail mailer settings

To get this information, open a new tab in your browser, log into your Gmail account, and open your Google Cloud Console dashboard.

Make sure you’re not logged into any other Google accounts besides the one you’ll be using for setting up SMTP before going any further.

Remember that if you use Google Workspace, the Google account you use must be able to send emails and have access to its own inbox.

If it’s your first time using Google Cloud, you’ll be asked to agree to the Terms of Service. Then, click on AGREE AND CONTINUE.

agreeing to google's terms of service

If you already have a Google Cloud project, make sure it’s selected from the Select a project dropdown at the top of your dashboard.

google cloud platform select a project

On the other hand, if you’re new to Google Cloud, you’ll need to set up a new project. Click Create Project.

google cloud platform create project

For a new project, enter a project name and select an organization and location from the dropdowns. Then, click on the CREATE button.

google cloud create new project

Enable the Gmail API

Next, you need to enable the Gmail API. Open the navigation menu from the top left corner of the screen. Then, go to APIs & Services » Library.

google cloud api services library

On the API Library page, now all you have to do is search for “Gmail API.” Then click on the Gmail API result and then the blue Enable button.

enable gmail api

Create Application Credentials

Once the Gmail API is enabled, you’ll be taken to its Overview page. Here, simply click on the CREATE CREDENTIALS button.

gmail api create credentials

Google will now ask you a few questions to determine your Credential Type. Under Which API are you using? select Gmail API.

google cloud select an api

Then scroll down a little to What data will you be accessing? heading. Go ahead and select User data and hit the Next button.

google cloud create credentials screen

Next, we need to set up a consent screen. Nobody will ever see this, but we need to do it before publishing your app.

The details in this form aren’t super important because nobody else will be using your app. It’s private to you. Here’s what we suggest:

  • Type in an App name that makes sense to you.
  • Pick your email from the User support email dropdown.
  • If you’d like, you can upload a logo for your app. This is optional.

Consent screen settings in Google Cloud

In the Developer contact information section, type your own email address. Now hit Save and Continue to save settings and move on to Scopes.

developer contact information gmail api

Configure Scopes (Optional)

Scopes aren’t required for your app, so we don’t need to use this section. Scroll past the entire section and hit SAVE AND CONTINUE again.

save and continue scopes in google cloud

Configure the OAuth Client ID

Now we’re ready to set up the Client ID. In the OAuth Client ID dropdown, select Web application. This will automatically populate some new fields.

OAuth web application

You can change the Name if you want, but it’s fine to keep the default. Then, scroll down to the Authorized redirect URIs section.

Click Add URI and paste in: from the WP Mail SMTP Setup Wizard. Hit Create to complete this step.

create authorized redirect url

When Google prompts you to download your credentials, copy the Client ID or wait till the 3rd step. Then, click the DONE button at the bottom of the page.

download your credentials

Step 2: Update the Publishing Status

If you have a free Gmail account, Google will have published your app in Testing mode. It’s super important to change this setting.

If you skip this step, your Gmail integration may frequently stop working. You may see the message Token has been expired or revoked in WP Mail SMTP.

We’re now going to edit your app to put it into Production. Follow the simple steps for both Google Workspace and Gmail Users below:

Google Workspace

Go to the APIs & Services » OAuth consent screen from the Google Cloud Console sidebar. Then, click on MAKE EXTERNAL under User type.

google cloud app make external

If the User type is set to Internal, only people in your company can use your app. This means, if you’re Workspace domain is, only those with an can access the app.

In the event that you enable WP Mail SMTP access to your application, any external email addresses used will be shown an error message that says Error 403: org_internal.

After you click on the MAKE EXTERNAL button, a new popup window will appear. Select the In production option here and then click on CONFIRM.

google cloud app in production

Gmail Users

If you’re using Gmail instead of a Google Workspace account, click APIs & Services » OAuth Consent Screen in the left-hand navigation pane.

OAuth consent screen

Under Publishing status, you’ll see the app status is set to Testing. Go ahead and click the PUBLISH APP button to update your app status.

publish app

You’ll see the message Your app will be available to any user with a Google Account. Click CONFIRM to publish your app.

push testing app to production

Don’t worry! Your account is secure.

No other user knows your Client ID and Client Secret, so they won’t be able to access your app. And WP Mail SMTP never asks for your Google username and Gmail password, so it’s completely secure.

After the confirmation process is finished, you will notice that the Publishing status of your app has been changed to In production.

google cloud app publishing status

Step 3: Grant Your Site Google / Gmail Permissions

Now, we’re going to copy and paste the Client ID and Client Secret into WP Mail SMTP. To do this, click on Credentials in the left-side menu.

api credentials

You can see information about the web app you just made in the OAuth 2.0 Client IDs section. Click the pencil button to see the Client ID and Client Secret.

credentials click pencil icon

This will show you everything about your app. The Client ID and Client secret are shown on the right side of this page.

client id and client secret

Great job! Please copy both of these values into the corresponding fields in your WP Mail SMTP settings to configure the Gmail SMTP server.

gmail mailer add client id and secret

When you have finished adding these values, you should then click on the Save Settings button at the bottom of the page.

google mailer save settings

Next, on the WP Mail SMTP settings page, click the button labeled Allow plugin to send emails using your Google account.

allow google to send emails

This will open a login screen for Google. Go ahead and log in, then click the Allow button to grant permission for your site to send emails.

allow google permissions

If you see a warning that your app is not verified, don’t worry. Free Gmail users will see this because Google hasn’t checked the app.

We don’t need Google to check it; anyone else won’t use the app. Go ahead and click on the Advanced link in the bottom left corner.

gmail oauth warning

In the expanded section, click on Go to (unsafe). Then, click on the Allow button, as shown below.

gmail oauth show advanced

Awesome job! You’ve now successfully connected WP Mail SMTP with the Gmail SMTP settings using the manual API method!

Set Up Your From Email and From Name in WP Mail SMTP

WP Mail SMTP gives you the option of forcing all plugins and contact forms to use the same From Name if you want to.

This is a quick and easy way to make sure your customers and visitors always see the same Name in the sender field of every email.

You don’t have to force this setting. You can choose to enable it here in the plugin settings if you want to.

Force From Name for Gmail in WordPress

Below that, there’s a From Email setting, and WP Mail SMTP will automatically show you all of the aliases set up on your Google Workspace or Gmail account.

The email address you pick in the dropdown here will be the default From Email in WordPress that all your emails will be sent from!

From Email dropdown in WP Mail SMTP

You can use any email listed in this dropdown to send email from WordPress. Just type it in as the From Email in your plugin or contact form settings.

WP Mail SMTP will authenticate the email for you. The “primary” email address that you select will be used as the default sender.

Want to add more Gmail aliases here? Check out how to send WordPress emails from a Gmail alias for a complete guide to setting them up.

If you want to check whether everything is working smoothly, also learn how to send a test email from WP Mail SMTP.

FAQs and Troubleshooting Google SMTP

Occasionally, our users run into issues with Gmail SMTP mail server in WordPress. Here’s a quick collection of FAQs that will help resolve any issues you have.

What do testing and production mean in Google Cloud Console?

In Google Cloud Console, Production means that your app is live. This is the default setting for Google Workspace users. Testing is the default setting for free Gmail accounts.

While Testing mode will work, it has a 7-day timeout. So every week, your emails will stop working and you’ll have to reconnect the app. To fix this, put your app into Production mode.

Does the Google / Gmail mailer have any sending limits?

Gmail and Google Workspace both have account-wide email-sending limits. These limits apply across your entire Google account.

Google Account Type Email Sending Limit (per day)
Google (free) 500
Google Workspace 2000

So, any emails sent from Google products (like Google Forms notifications) will count. The emails you send from your regular mailbox count toward it, too.

What do the options “Internal” and “External” mean?

In Google Cloud Console, Internal means that the app will be available to your organization. This is the default setting for Google Workspace users.

External means that the app will be available to any Google account. This is the default setting for free Gmail accounts because they aren’t part of an organization.

You don’t need to worry about this setting. You can go ahead and use the default that Google selects for your account.

Why can’t I use my Domain for the “Authorized Redirect URI”?

The Authorized Redirect URI is only used when you connect your site to Gmail the first time. We provide our own URL for this initial connection so that you don’t experience any issues with security plugins or mod_security on your server.

Why do I see a DMARC, SPF, or DKIM warning?

WP Mail SMTP has a built-in Domain Checker. It automatically scans your domain’s DNS records for rules called DMARC, SPF, and DKIM and will warn you if they are missing.

If you’re using Google Workspace or a custom domain with Gmail, we recommend adding these to your DNS. Jump down to our table of common Gmail errors for instructions.

Free Gmail users (without a custom domain) can ignore these warnings. As a free Gmail user, you don’t have control over the sending domain’s DNS, so you can’t add these records.

Why do emails from WordPress appear in the sent folder in Gmail?

When you use WP Mail SMTP to send mail using the Google API, it’s essentially the same as you sending them yourself from your ordinary mailbox.

So every email that’s sent from your site will appear in your Sent Mail folder in your mailbox as well.

If you don’t want this to happen, we recommend that you choose a different mailer like SendLayer.

How do I switch Gmail accounts in WP Mail SMTP?

If you want to send email from a different Gmail address in WordPress, you have 2 options with WP Mail SMTP.

Use a Gmail Alias

WP Mail SMTP lets you send emails from multiple Gmail or Google Workspace aliases. So if you want to use a different From Email address, you can easily add it as an alias in your Google account.

To learn how to add an alias and use it in WordPress, check out how to send WordPress emails from a Gmail alias.

Switch Google Accounts

If you’d like to change to a different Gmail or Google Workspace email account, you’ll need go to WP Mail SMTP » Settings and click the Remove Connection button.

Remove Gmail connection

After disconnecting your account, scroll up to the Mail section and click Launch Setup Wizard to create a new Gmail SMTP connection.

Launch Setup Wizard in WP Mail SMTP

Remember: clicking Launch Setup Wizard will erase your existing settings, so it’s best not to click it unless you’re ready to switch.

Now, let’s list some common error messages and solutions in case you run into a different problem when you set up Gmail.

Gmail SMTP / Mailer Error Messages and Solutions

Error Message Solution
  • Invalid grant
  • Token has been expired or revoked
  • Error 403: access_denied
    The developer hasn’t given you access to this app. It’s currently being tested and it hasn’t been verified by Google.
Your Google app is likely still in Testing mode. While this will work, your connection will break every 7 days.

To fix this, it’s easy to put your app into Production mode.

  • 401. That’s an error. Error: invalid_client
  • 400. That’s an error. Error: invalid_request Missing required parameter: client_id
Head to WP Mail SMTP » Settings and click the Launch Setup Wizard button. Copy the Client ID in again.

Check that there’s no whitespace or extra text at the start or end of the Client ID.

cURL error 60: SSL certificate problem Contact your site’s hosting provider to ask them to install this certificate. It’s most likely the cacert.pem certificate, though it’s best to ask your host to check.
Login Required
Head to WP Mail SMTP » Settings and click the Launch Setup Wizard button. Run through the Setup Wizard again and be sure to connect your Google Account to WP Mail SMTP.
Request is missing required authentication credential.
Expected OAuth 2 access token, login cookie or other valid authentication credential.
This means your Gmail setup is not complete. Head to WP Mail SMTP » Settings and click the Launch Setup Wizard button to check your settings.
Google hasn’t verified this app
The app is requesting access to sensitive info in your Google Account.
To bypass this message, you’ll need to click Advanced and then Proceed.

Don’t worry – your app does not need to be verified by Google to work.

Action Needed: It doesn’t look like the SPF record required by Google has been added to your domain.
Please check out Google’s SPF guide for details on how to add this record to your domain’s DNS.
WP Mail SMTP can’t find an SPF record in your DNS. Adding an SPF record could help improve email deliverability.

If you’re using Google Workspace or a Gmail account with a custom domain, follow Google’s tutorial to solve this.

If you’re using a free Gmail account without a custom domain, you can ignore this warning.

Action Needed: It doesn’t look like the DKIM record required by Google has been added to your domain.
Please check out Google’s DKIM guide for details on how to add this record to your domain’s DNS.
WP Mail SMTP can’t find a DKIM record in your DNS. Adding a DKIM record could help improve email deliverability.

If you’re using Google Workspace or a Gmail account with a custom domain, follow Google’s tutorial to solve this.

If you’re using a free Gmail account without a custom domain, you can ignore this warning.

Action Recommended: It doesn’t look like DMARC has been set up on your domain (
We recommend using the DMARC protocol because it helps protect your domain from unauthorized use.
Please check out our step by step guide for details on how to add this record to your domain’s DNS.
WP Mail SMTP can’t find a DMARC record in your DNS. Adding a DMARC record could help improve email deliverability.

If you’re using Google Workspace or a Gmail account with a custom domain, read how to add a DMARC record to your domain. This article includes a generic DMARC example you can copy and paste.

If you’re using a free Gmail account without a custom domain, you can ignore this warning.

If your error message isn’t listed here, you can contact WP Mail SMTP support:

Next, Grow Your Business with WordPress

Now that your emails are sending perfectly, it’s time to check out our roundup of the best email plugins for WordPress. If you’d like, check out other roundups for different use cases related to your WordPress website:

Create Your WordPress Form Now

Ready to build custom WordPress forms? Get started today with the easiest WordPress form builder plugin.

WPForms Pro includes 1,800+ free templates and offers a 14-day money-back guarantee. And you can collect payments through Stripe, Square, and PayPal for your business.

If this article helped you out, please follow us on Facebook and Twitter for more free WordPress tutorials and guides.

Using WordPress and want to get WPForms for free?

Enter the URL to your WordPress website to install.

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our privacy policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.

This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.