Product support

Visit this product's website for support.


Easily send email using Gmail. This plugin adds support for using Gmail as the system email service. Messages are sent using the Gmail API, which avoids the problems associated with using SMTP.


  • A Gmail account (G Suite accounts are also supported)
  • Gmail API credentials

Bugs & Feature Requests

  • If you found a bug, or the plugin behaves unexpectedly, please open an issue on the GitHub repository.
  • If you have an idea for a new feature, please open an issue on the GitHub repository.


  • This plugin is not officially associated with Google. All product names, trademarks and registered trademarks are property of their respective owners. All company, product and service names used in this website are for identification purposes only. Use of these names,trademarks and brands does not imply endorsement.
Successful configuration

Plugin Settings

The plugin is configured in your October CMS backend settings. Change the mail method to Gmail in Mail configuration, save the settings and go to Gmail configuration to upload your API credentials. Obtain API credentials from the Google Cloud Console.

Obtaining API Keys

  1. Go to the Google Cloud Console and create a new project.
  2. Give your project a name, and click Create. Wait for your project to be created.
  3. Click the Create credentials dropdown and choose OAuth client ID
  4. You may be asked to configure the OAuth consent screen
    1. Set the Application name
    2. Add your domain to the Autorized domains list
    3. Configure any other option as you like. More info here.
  5. Select Web application as the Application type, and give it a name.
  6. Copy the Authorized Redirect URI from the backend Gmail configuration page.
  7. Add that URI as an Authorized redirect URI and click Create
  8. Look for your new credential in the OAuth 2.0 Client IDs table, and click the download button to download your credentials in JSON format.
  9. Click on Library in the sidebar and search for "Gmail". Click Enable to enable access to the Gmail API.
  10. Upload the file you downloaded to the backend Gmail configuration page and save the settings. Reload the page to show the Authorize button.
  11. Click the Authorize button to open the Google consent page. Continue to select the account you want to send email with and consent to sending email on your behalf.
    • You may encounter a screen that says "This app isn't verified". This is referring to the OAuth consent screen that you created, and can be bypassed by clicking Advanced and then Go to <domain> (unsafe).

Testing delivery

To make sure everything is working, try test sending a mail template to yourself.

Revoking access

In case you want to revoke access, click Reset to default on the Gmail configuration page. This will delete the credentials and access tokens. You may also want to remove app access on your Google account.

Important Notes

  • The Gmail API will only send emails as the account which you granted access with, it is currently not possible to send email as another user.
  • The maximum email size is 25MB

Improve UI

May 08, 2020


Increased max sending size to 35MB.

Mar 13, 2020


Added ability to change auth scopes used with the Google API client.

Mar 13, 2020


Improved localization.

Feb 24, 2020


Plugin required elevated permissions.

Nov 19, 2019


Added settings permissions

Nov 19, 2019


Added authorization status dashboard widget.

Nov 05, 2019


Cleaned up Gmail API authorization flow.

Nov 04, 2019


Fixed issue where backend authorization status showed expired when it was authorized.

Nov 04, 2019


Fixed logic issues, app is removed from user account when settings are reset. Updated dependencies.

Aug 29, 2019


Fixed errors that occur when invalid credentials are supplied

Jun 12, 2019


Initialized plugin

Jun 04, 2019