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. 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.

A reply being composed in the PressedG layout.

PressedMail screenshot with fictional email. PressedG is a layout name, not proof that this mailbox is connected to Google.

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, Email Connections, Add Account, and 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.

Drawn Gmail account setup illustration.

Interface illustration of the Gmail setup step. No Google app password is displayed.

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.

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

$49/ year
1 Website
  • All current and future Premium features
  • Unlimited email accounts
  • Contacts, calendar, and email rules
  • AI tools and phishing detection
  • Layouts, themes, and workspace controls
  • Licensed updates and priority support
Most Popular

Premium

For multiple sites

$89/ year
10 Websites
  • All current and future Premium features
  • Unlimited email accounts
  • Contacts, calendar, and email rules
  • AI tools and phishing detection
  • Layouts, themes, and workspace controls
  • Licensed updates and priority support

Ultimate

For agencies

$169/ year
100 Websites
  • All current and future Premium features
  • All current and future Ultimate features
  • Unlimited email accounts
  • Contacts, calendar, and email rules
  • AI tools and phishing detection
  • Licensed updates and priority support

See how people use PressedMail for real inbox work.

...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 installed PressedMail, added my accounts, and automated the cleanup of over 3000 emails. PressedMail has saved me hours of work.

Robert H. Alexander

Robert H. Alexander

...Helps get more clients...

As a freelancer I need to manage several clients' accounts. I installed PressedMail on WordPress on localhost and use it as my main email client. I manage everything for clients from PressedMail. And several clients use PressedMail now after I have set their WordPress instances up.

Gene Piki

Gene Piki

...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.

Kit M. InCurb Digital Solutions.

Kit M. InCurb Digital Solutions.

...Fast inbox organization with phishing detection...

PressedMail helps us organize our inboxes fast. We especially like the phishing detection feature.

John & Andrea

John & Andrea

...One source of truth for every client...

As a VA, I use PressedMail to keep each client's inbox separate while managing everything from one app. It gives me a single source of truth without mixing client work together.

Edhrea A.

Edhrea A.

...Teaching and client work stay organized...

I balance teaching with social media marketing clients. PressedMail helps me keep both sides of my work organized in one place.

J.A. Payo

J.A. Payo

Using PressedMail in your own work? Submit a testimonial.

FAQ

Common questions

Roadmap

See what is coming next.

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

View Full Roadmap
  1. Shared Inboxes for Team Mailboxes

    Share a single inbox with teammates so support, order, and operations email can be monitored and handled together from WordPress.

    Planned
  2. Shared Calendars for Scheduling and Coverage

    Give teammates access to shared calendars so meetings, time off, and internal event planning can stay coordinated inside WordPress.

    Planned
  3. Calendar Sync with External Providers

    Planned two-way calendar sync with external providers like Google Calendar, Outlook, iCloud, and CalDAV so PressedMail stays in step with calendars users already have.

    Planned

Get started

Bring your working inbox into WordPress.

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