Take 22% off yearly plans. Use code "POWERUP22" at checkout. See plans

Gmail App Passwords for WordPress: Setup Guide

Check whether your Google account supports app passwords, create a credential for WordPress, and understand when replacement or revocation is needed.

Cover image for Gmail App Passwords for WordPress: Setup Guide

A Google app password is a separate credential for an application that cannot use Google’s sign-in flow. Google’s own help says app passwords are not recommended and are unnecessary in most cases, because it prefers “Sign in with Google”. PressedMail’s Gmail connection does not offer that sign-in, so for a personal Gmail account the app password is the route. Google also says IMAP access has been always on for personal accounts since January 2025, so there is no Enable IMAP switch to look for. It is the supported credential for eligible Gmail accounts in PressedMail. Google sign-in is not available in this connection flow.

Check eligibility before creating anything. Google requires two-step verification for app passwords, and some accounts do not offer the option. Google’s app-password help lists restrictions including Advanced Protection, some managed accounts, and security-key-only configurations.

If your account does not offer an app password, the current PressedMail Gmail connection is unavailable for that account. Repeated password resets will not fix that mismatch.

Decide which connection you are configuring

There are two common WordPress uses for Gmail. An email client reads messages through IMAP and sends replies through SMTP. A WordPress SMTP configuration sends site-generated messages such as form notifications.

Both involve authentication, but they are separate configurations in PressedMail. The inbox account does not automatically become the WordPress SMTP server. Use the Gmail IMAP connection guide for a readable mailbox and the Gmail SMTP guide for outgoing site mail.

For work or school mail, read the Google Workspace access guide first. The organization’s allowed method takes precedence over a generic tutorial.

Create the credential

1. Check the signed-in Google account

Open your Google Account in a browser and confirm the email address. If several accounts are signed in, switch to the mailbox you want WordPress to use.

A credential created under one Google account will not authenticate another. This can look like a mysterious password problem when the browser quietly chooses a different account.

2. Check two-step verification and availability

Review the account’s security settings. Then open Google’s App passwords page.

If the option is absent, stop at the eligibility check. For a managed account, ask the administrator whether app passwords are allowed. Do not disable account protections or change organization policy to follow a tutorial.

Google recommends its own sign-in flow where the application supports it. The current Gmail client-access guidance also describes app passwords for eligible situations. The client and account must support the same route.

3. Give the app password a useful name

Create a name that identifies the site and purpose, such as “WordPress support inbox.” Avoid a vague name like “Mail” when several applications use the account.

The name is for your records. It does not restrict the credential to a particular website or make it harmless if exposed.

Copy the generated value into the intended application’s password field. Never put it in an article, screenshot, support ticket, issue, or email. If you accidentally expose it, revoke that credential and create another.

4. Enter it in the right PressedMail form

For a Gmail inbox, open Settings, then the Accounts tab, choose Add Account, and pick Gmail. Enter the full mailbox address and the app password in Account Credentials.

Use the Gmail IMAP reference if you need to check incoming settings. The PressedMail Gmail documentation covers the preset and account form.

For WordPress system mail, configure the separate SMTP server under WordPress Email. Do not paste the app password into your WordPress user password field.

The Add an email account step with the Gmail and Outlook cards and two buttons numbered

  1. Gmail’s App password button.
  2. Outlook’s Sign in with Microsoft button. Outlook also has an App password option above it for accounts that allow one.

After you choose Gmail, PressedMail shows the credentials step.

The Gmail account credentials step with six areas numbered

  1. The instructions PressedMail shows. Use a generated Gmail app password, turn on 2-Step Verification first, create the password with the name PressedMail, then paste it.
  2. A link to Google’s app passwords page, which opens in a new tab.
  3. Your full mailbox address.
  4. The display name people see on your messages.
  5. The app password. PressedMail removes the spaces Google puts in it.
  6. Next. Moves to the server settings.

The values in the picture are placeholders and no password is shown.

5. Test the intended job

Run the relevant connection test. Then verify one controlled message.

For an inbox, check both receipt and a reply. For site mail, trigger a test through the WordPress sending path and check the recipient. A connection test and actual receipt are useful but different observations.

If the test fails, copy the sanitized error and note whether it came from IMAP or SMTP. Avoid generating a collection of replacement credentials before you know which part failed.

If App passwords is missing

The missing option can reflect the account’s security configuration or organization rules. It is not evidence that WordPress is broken.

First confirm the correct Google account. Then check the prerequisites in Google’s help page. For a managed account, send the administrator the requirement: a third-party IMAP/SMTP client using an app password. That is more useful than asking for an unspecified “email fix.”

If the permitted route is OAuth only, choose a client that supports Google’s sign-in flow. Keep Gmail available while deciding; there is no need to migrate the mailbox or weaken its protection.

When Gmail is slow or refuses a connection

Google’s help lists two limits worth knowing. You can add Gmail to up to 15 email clients at a time for one account, and more than that can give a “Too many simultaneous connections” error. Close or sign out of clients you no longer use.

If a client crashes or takes too long to download mail, Google suggests limiting which folders sync. In Gmail’s settings, under Forwarding and POP/IMAP, the IMAP section has a folder size limit, so IMAP only syncs folders with a set maximum number of messages. A managed account may not show that tab. Google’s client help has the details.

Replacement and removal

Changing the main Google Account password revokes existing app passwords. If a connection stops after that change, replace its dedicated credential and update the corresponding WordPress configuration. You can also revoke an individual app password when a site or application no longer needs access. Google documents both behaviors.

Remove access in two places when retiring a site connection: remove the unused connection in WordPress and revoke its Google credential. Revoking future access does not erase messages already present in a client’s local storage or backups.

A WordPress installation with mailbox access deserves the same care as another business application holding credentials. Limit access to the relevant user, keep the installation maintained, and review email display and WordPress access precautions.

FAQ

Is an app password the same as an OAuth token?

No. An app password is a credential supplied to a compatible application. OAuth uses an authorization flow and tokens with the permissions granted through that flow. The difference affects how access is granted and removed.

Can I retrieve the same app password later?

Google shows the generated value once. If you no longer have it, create a replacement and remove the unused credential from the account.

Does enabling two-step verification guarantee the option appears?

No. Other account restrictions may still prevent app-password creation. Check the account’s eligibility rather than assuming the option must appear.

Should I use one credential for every WordPress site?

A dedicated credential per site makes the connection easier to identify and revoke without disturbing another site. Keep an inventory of what each credential is for.

Does PressedMail Free remove Google’s restrictions?

No. Free provides the WordPress client for a compatible mailbox. Google continues to control which authentication methods that mailbox permits.

Manage your email inside WordPress

PressedMail Free adds an email client directly to your WordPress dashboard. Connect a compatible IMAP/SMTP mailbox, read and send mail, organize messages, and configure WordPress SMTP.

Download PressedMail Free →

Newsletter

Get useful PressedMail updates.

New releases, setup guidance, and practical ways to handle email in WordPress.

Occasional PressedMail email. Unsubscribe whenever you like.

Choose the plan that fits your WordPress sites.

Paid plans include unlimited accounts and users. Compare Premium and Ultimate features, then choose the site count you need.

Yearly plans are priced by number of sites. Lifetime is a one-time payment covering up to 100 sites.

Starter

For one site

$39/ year
1 Website
  • All current and future Premium features
  • Unlimited email accounts
  • Contacts, calendar, and scheduled email rules
  • Templates, blocks, and signup forms
  • AI tools and phishing detection
  • Layouts, themes, and workspace controls
  • Licensed updates and priority support
  • 10,000 PressedMail AI credits a yearLimited time
Most Popular

Premium

For multiple sites

$69/ year
10 Websites
  • All current and future Premium features
  • Unlimited email accounts
  • Contacts, calendar, and scheduled email rules
  • Templates, blocks, and signup forms
  • AI tools and phishing detection
  • Layouts, themes, and workspace controls
  • Licensed updates and priority support
  • 25,000 PressedMail AI credits a yearLimited time
All Features

Ultimate

For agencies

$129/ year
100 Websites
  • Everything in Premium, plus:
  • Campaigns and shared templates
  • Share inboxes, calendars and contact lists
  • White labelling with a brand theme
  • 50,000 PressedMail AI credits a yearLimited time

What customers say after bringing email into WordPress.

Using PressedMail in your own work? Submit a testimonial

I save hours & it’s easy to use

I have a lot of email accounts, and it’s annoying to manage them through different providers. I needed something better than what was out there, so I built it. I spent the better part of two years making PressedMail the plugin I wanted to use every day, and now I get to share it with everyone else. I added my accounts, automated the cleanup of over 3000 emails, and it’s saved me hours of work.

Robert H. AlexanderFounder - CurbSoftwareCreator of PressedMail

Email Swiss Army Knife

We use PressedMail as a value added service for clients and potential clients as a feature of our agency’s offering helping put us ahead of competition. We love the white-labelling feature, automation, and security controls. It also replaces several of the other plugins we used to use and it’s like a small CRM.

Gene Piki
FAQ

Common questions

Free version

Start with one inbox. Free.

One mailbox for one user, a rich-text composer, custom folders, unlimited email rules, one signature, two themes and one layout. Contacts, calendar, scheduling and AI require a paid plan.

1 account · 1 user · 2 themes · unlimited rules
Roadmap

See what is coming next.

Follow planned work, current progress, and recently completed features.

  1. In Progress

    WooCommerce Integration

    Connect PressedMail with WooCommerce so order, customer, and store email flows stay tied to the right orders and customer records inside WordPress.

  2. Planned

    Calendar Sync with External Providers

    Planned. Today calendars and events live in WordPress and do not sync with any outside provider. Two-way sync with Google Calendar, Outlook, iCloud and CalDAV-compatible services is on the roadmap.

  3. Planned

    Dedicated Support

    A higher-touch support channel beyond the current paid Priority Email Support entitlement.

Bring your working inbox into WordPress.

Compare Premium and Ultimate features, then choose a paid plan for the number of WordPress sites you manage.