Gmail SMTP Plugin for WordPress

Gmail SMTP is an advanced SMTP mailing plugin for WordPress for sending an email via Gmail SMTP server. Unlike most SMTP plugins It uses the OAuth 2.0 protocol to authorize access to the Gmail API instead of password authentication.

gmail smtp wordpress plugin

Gmail SMTP Benefits

1. Gmail SMTP plugin does not store your password. It uses the OAuth 2.0 mechanism for SMTP authentication. It means a more secure login system for users.

2. Gmail SMTP plugin uses PHPMailer – a very popular PHP library used in the core WordPress for sending an email. This is to make sure that users can still get full benefits of the default email functionality.

3. Gmail SMTP plugin takes a big headache away from you because you no longer need to Allow Less Secure Apps on your Gmail account. This is an option that users had to enable in order to fix SMTP connection issue. This issue went viral from December 2014, when Google started imposing OAuth 2.0 authentication to access their apps. This option affects SMTP mailing because applications that perform password authentication to IMAP, POP, or SMTP are considered Less Secure Apps.

As far as I know, this issue still affects almost all the SMTP plugins out there.

How OAuth 2.0 Authorization Works

1. You register a web application in the Google Developers Console.

2. When this application is launched it requests that you give it access to data in your Google account.

3. If you consent, the application receives credentials to access the API.

Installation

You can install the Gmail SMTP plugin in one of the following ways:

Option 1 (Quick & Easy install)

  1. Go to Plugins->Add New from your WordPress admin dashboard
  2. Search for “gmail smtp naa986”
  3. Click Install once you have found it

Option 2 (Manual install)

  1. Download the zip version of the plugin
  2. Go to Plugins->Add New
  3. Click Upload Plugin
  4. Select the zip file on your computer
  5. Install it

Gmail SMTP Configuration

In order to get started with the plugin go to Settings->Gmail SMTP from your admin dashboard.

screenshot of gmail smtp plugin menu

Gmail SMTP Project Creation

1. Go to console.cloud.google.com/apis/dashboard.

2. Login to your Google account which will be used to send an email.

3. Create a new project where your application will be registered.

screenshot showing how to create a new project in the Google Developers Console

It doesn’t have to be “Gmail SMTP Project 1”. You can name it whatever you like. I chose a meaningful name because I have multiple projects in it.

Credentials/App Creation

1. Once the project is created go to Credentials > CREATE CREDENTIALS and select OAuth client ID.

2. In order to create an OAuth client ID, you need to configure the OAuth consent screen first. So click CONFIGURE CONSENT SCREEN.

screenshot showing how to configure the consent screen when creating an OAuth Client ID

3. Choose how you want to configure and register your app. Since I’m not using G Suite I had to choose External.

screenshot showing how to choose a user type in the oauth consent screen of the google developers console

4. Enter a name (e.g. Gmail SMTP) for the OAuth consent screen.

screenshot showing the OAuth consent screen 2 in the google developers console

5. You can configure optional fields such as Authorized domains, Application home page, Application privacy policy link and Application terms of service link (I was able to skip all and click SAVE AND CONTINUE). You do however need to enter an email address under the Developer contact information section.

screenshot showing part 2 of the consent screen 2 in the google developers console

6. Skip the Scopes screen.

screenshot showing the Scopes tab in the OAuth consent screen of the Google cloud console

7. Add a test user if you plan to use this app in test mode (This is not required if you want to publish it).

screenshot showing the Test users tab in the OAuth consent screen of the Google cloud console

8. Keep your app in test mode or publish it. If the Publishing status is set to In production, a warning message (This app isn’t verified) may appear on the consent screen that you can easily skip.

screenshot showing the Summary tab in the OAuth consent screen of the Google cloud console

Now that the OAuth consent screen has been configured you can create an OAuth Client ID.

9. Go to the Credentials tab and select OAuth client ID under CREATE CREDENTIALS.

screenshot showing how to select OAuth client Id under CREATE CREDENTIALS in the google developers console

10. Set the application type to Web application and enter a name for it (e.g. Gmail SMTP App). Copy the Authorized Redirect URL from the settings and paste it into the field here.

screenshot showing how to create a client id by creating a new web app in the google developers console

11. Click Create. This will generate a Client ID and Client Secret for you. Copy and paste them into the settings area of the plugin.

Gmail SMTP Settings Configuration

1. Configure the rest of the settings. It includes,

OAuth Email Address: The email address that you will use for SMTP authentication. This should be the same email used in the Google Developers Console.

From Email Address: The email address which will be used as the From Address when sending an email.

From Name: The name which will be used as the From Name when sending an email.

Type of Encryption: The encryption which will be used when sending an email (either TLS/SSL). By default, it should be set to TLS since SSL has been deprecated since 1998.

SMTP Port: The port which will be used when sending an email. If you choose TLS it should be set to 587. For SSL use port 465 instead.

2. Click Save Changes.

Now that you have configured the settings a Grant Permission button will appear.

screenshot showing how to grant permission from the gmail smtp settings

3. Clicking on it will take you to a consent screen where you will be able to grant this app access to the Gmail API.

allow application screen of google developers console

4. When you click Allow you will get redirected back to the plugin settings. You should see a message like Access Granted Successfully. The SMTP Status should also get set from Not Connected to Connected.

screenshot of gmail smtp settings

That’s it. Gmail SMTP plugin will now be able to take control of all outgoing email from your website.

Test Email

In order to test the email functionality, you can send a test email from the Test Email tab.

Debug option is enabled by default for the test email functionality – which means you would be able to see if the plugin was able to send the email without any error.

screenshot showing how to send a test email from the gmail smtp plugin settings

Troubleshooting

By default, your SMTP port should be configured on 587 (with TLS encryption). If you can’t get it to work then you can try changing it to 465 (with SSL encryption).

If you still can’t get either to work try port 25 with TLS first and then SSL. Please note that most servers don’t support encryption on port 25, which is why port 587 and 465 are the preferred options.

Fresh Authorization / Removing Access From the Application

For some reason, if you ever want to stop using this plugin or do a fresh authorization this option might come in handy.

Revoke Access menu allows you to remove access from a previously authorized application.

screenshot showing the revoke access settings of gmail smtp plugin

First, you need to click on the account settings link. This will take you to a page where you can remove access from the Gmail SMTP application.

screenshot showing how to remove access from an application in the google developers console

Once you have removed access from it, go back to the Remove Access tab in the plugin settings and delete the Access key.

Access key is a token that the plugin received when you first granted your app access to the Gmail API. This token is necessary to communicate with the Gmail API and send an email. In order to avoid any confusion, the plugin does not show it on the settings page.

Once you delete this token the plugin can no longer connect to the Gmail SMTP server or send an email. This means you will need to reauthorize (using the web application link in the settings) before you can start using the plugin again. However, you won’t need to set up everything from scratch as long as the project still exists in your Google Developers Console.

Gmail SMTP Add-ons

Gmail SMTP plugin comes with add-ons that you can use to enhance its functionality on your website.

Reply-To

Reply-To add-on lets you set a reply-to address for all outgoing email messages.

Cc

Cc add-on lets you set a cc recipient for all outgoing email messages.

712 thoughts on “Gmail SMTP Plugin for WordPress”

  1. Hello,

    I have connected my API. It seems to be correct. But while testing email I receive the following mistake:

    Fatal error: Uncaught TypeError: Cannot access offset of type string on string in /var/www/my_domain_example.com/public_html/wp-content/plugins/gmail-smtp/main.php:677 Stack trace: #0 /var/www/my_domain_example.com/public_html/wp-includes/class-wp-hook.php(307): gmail_smtp_pre_wp_mail() #1 /var/www/my_domain_example.com/public_html/wp-includes/plugin.php(189): WP_Hook->apply_filters() #2 /var/www/my_domain_example.com/public_html/wp-includes/pluggable.php(222): apply_filters() #3 /var/www/my_domain_example.com/public_html/wp-content/plugins/gmail-smtp/main.php(186): wp_mail() #4 /var/www/my_domain_example.com/public_html/wp-content/plugins/gmail-smtp/main.php(123): GMAIL_SMTP->test_email_settings() #5 /var/www/my_domain_example.com/public_html/wp-includes/class-wp-hook.php(307): GMAIL_SMTP->options_page() #6 /var/www/my_domain_example.com/public_html/wp-includes/class-wp-hook.php(331): WP_Hook->apply_filters() #7 /var/www/my_domain_example.com/public_html/wp-includes/plugin.php(474): WP_Hook->do_action() #8 /var/www/my_domain_example.com/public_html/wp-admin/admin.php(259): do_action() #9 /var/www/my_domain_example.com/public_html/wp-admin/options-general.php(10): require_once(‘…’) #10 {main} thrown in /var/www/my_domain_example.com/public_html/wp-content/plugins/gmail-smtp/main.php on line 677
    There has been a critical error on this website. Please check your site admin email inbox for instructions.

    Any ideas?
    Thanks

    Reply
  2. Follow up. Server info”

    OS: Linux my_domain.com 5.4.0-88-generic #99-Ubuntu SMP Thu Sep 23 17:29:00 UTC 2021 x86_64
    PHP version: 8.0.11
    WordPress version: 5.9
    WordPress multisite: No
    openssl: Available
    allow_url_fopen: Enabled
    stream_socket_client: Available
    fsockopen: Available
    cURL: Available
    cURL Version: 7.68.0, OpenSSL/1.1.1f

    Reply
  3. Hi, I’m doing all the work well, but in the end I get this error for connecting the website to Google. “The has been a critical error on your website”

    please help…

    Reply
    • Same thing happens to me, any solution?

      Reply
  4. Just to say THANK YOU for your perfect explanation.
    Works great.

    Regards Alan

    Reply
    • @alan, You’re welcome 🙂

      Reply
  5. I am getting the following error when trying to send a test message: command not implemented

    This is using TLS. Any ideas?

    Reply
  6. Seems to work fine! Any recommendations on SPF records?

    Using this now:

    v=spf1 a mx ptr a:gmail.com include:gmail.com ~all

    Reply
  7. 2022-07-14 11:13:47 Connection: opening to smtp.gmail.com:465, timeout=300, options=array()
    2022-07-14 11:13:48 Connection failed. Error #2: stream_socket_client(): unable to connect to smtp.gmail.com:465 (Network is unreachable)
    2022-07-14 11:13:48 SMTP ERROR: Failed to connect to server: Network is unreachable (101)
    SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting

    Reply
    • @Priya, Have you tried TLS on port 587?

      Reply
  8. Hi there, are there any plans to upgrade to GuzzleHTTP v7? I have another plugin installed that uses v7 of this library and if I have both plugins activated, it doesn’t send out mails anymore.

    Reply
    • @Michael, Do you see any error? Simply upgrading may not help if there is a naming conflict.

      Reply
      • Yes I see an error when I try to send a test mail.

        Reply
        • @Michael, Can you please share the error message?

          Reply
          • You can see the error message here:
            https://pastebin.com/2DwxFzn4

          • Does this error message help you?

  9. The grant permission part doesnt show on my end could you help ?

    Reply
    • @Mac, Have you set up the plugin before?

      Reply
  10. I have followed these instructions over and over again for 8 hours today and I keep getting to the end and this message pops up. Any suggestions? This is driving me INSANE.

    Sign in with Google
    Access blocked: This app’s request is invalid

    hello@brenslist.com
    You can’t sign in because this app sent an invalid request. You can try again later, or contact the developer about this issue. Learn more about this error
    If you are a developer of this app, see error details.
    Error 400: redirect_uri_mismatch

    Reply
    • Take another look at Step 10 > “Copy the Authorized Redirect URL from the settings and paste it into the field here.”

      Reply
  11. I could not get past the OAuth consent screen. It just says “An error saving your app has occurred” even though I supplied emails etc. No indication what the error is.

    Reply
    • I had the same problem. Putting the App ID for the “App name” field did the trick. The ID should just be the name of the Google app but with hypens and all lowercase (i.e. My Test Website -> my-test-website). You can also find the ID in the project selector.

      Reply
  12. I’ve tried hard and by the looks I have all the right settings.
    When I try to send a test email I just get a blank screen, and nothing happens.
    In debug log I don’t get anything about email, smtp etc – not a mention.
    From Contact form I get an error occured.
    Any suggestions on what to look for.

    Reply
  13. I’m running a two-site multisite with a www site and a second one on a subdomain. Both show the green checkmark for SMTP Status connected, but only the www site is able to send. The other shows ‘SMTP Error: Could not authenticate.’ when I try to send a test mail. These two are both using the same email account with the same client id/secret and both seem to have authorized properly… both of the redirect URIs are associated with the same API on Gmail. Any idea what else I may need to do?

    Reply
  14. Dear,
    Is possible that Google delay some time in autorizeed me?
    Because I did it the same, but continous without autorized when try to verify my acount by Gmail permiss.
    Please let me know.
    Thanks,

    Reply
  15. I have DMARC/DKIM/SPF set up on our domain (we use Google Workspace and CloudFlare for DNS).

    Do I need to do anything in the Gmail SMTP settings to ensure mails sent from PHPMailer pass DMARC/DKIM/SPF? Or is that handled at source by Google?

    Reply
  16. Hello,
    Can we use your plugin to authenticate when the domain is different to the GSuite verified domain? We’re getting this error:
    2024-03-13 04:08:52 Connection: opening to smtp.gmail.com:587, timeout=300, options=array()
    2024-03-13 04:08:53 Connection failed. Error #2: stream_socket_client(): Unable to connect to smtp.gmail.com:587 (Network is unreachable) […/public_html/wp-includes/PHPMailer/SMTP.php line 396]
    2024-03-13 04:08:53 SMTP ERROR: Failed to connect to server: Network is unreachable (101)
    SMTP connect() failed. https://github.com/PHPMailer
    /PHPMailer/wiki/Troubleshooting

    Domain: xx-abcde.com.au
    Gsuite domain: xxabcde.com.au

    Thanks!

    Reply
    • I have the same error. What we can do?

      2024-08-16 21:09:46 Connection: opening to smtp.gmail.com:587, timeout=300, options=array()
      2024-08-16 21:09:47 Connection failed. Error #2: stream_socket_client(): Unable to connect to smtp.gmail.com:587 (Network is unreachable) [/home2/southcom/public_html/wp-includes/PHPMailer/SMTP.php line 409]
      2024-08-16 21:09:47 SMTP ERROR: Failed to connect to server: Network is unreachable (101)
      SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting

      Reply
      • @Marcos, The specified port may be blocked on your server.

        Reply
  17. I always get this error: The request has been classified as abusive and was not allowed to proceed when trying to create the consent screen

    Reply
  18. Hello, I am not able to set up my STMP. I get this message.

    Access blocked: Authorization Error
    The OAuth client was not found.
    If you are a developer of this app, see error details.
    Error 401: invalid_client

    What can I do to fix this?

    Thank you.

    Reply
    • @Melissa, Please make sure that all the credentials are correct.

      Reply

Leave a Reply to Krista Cancel reply