How to Add Gmail to the iPhone Mail App Properly

Adding a Gmail account to the iPhone Mail app takes under two minutes, and for almost everyone it needs nothing more than your email address and password — Apple hands the actual sign-in off to Google. The setup isn't where people get stuck. What trips them up is everything that happens after: the swipe button says Archive instead of Delete, notifications feel a beat slower than the dedicated Gmail app, and a folder called All Mail shows up holding a copy of everything.

None of that is a bug. It's IMAP — the protocol Apple Mail actually uses to talk to Gmail — behaving exactly the way IMAP behaves, and once you know why, most of it is a one-time settings change rather than something to just live with. This guide covers the add-account steps once, briefly, then spends the rest of its time on the differences that actually change how you use the account day to day.

The short answer#

Open Settings, go to Mail — Apps → Mail on iOS 26's reorganized layout, just Mail on iOS 18 and earlier — then tap Accounts and Add Account, and choose Google. Sign in on the screen that appears, which is Google's own login page rendered inside Mail, not a form Apple built itself. Turn on Mail for that account and it starts syncing over IMAP.

Everything else in this guide traces back to that one detail: Gmail's own app talks to Google's servers using Google's private sync protocol, while Apple Mail talks to the same account over the open IMAP standard. Same mailbox, two different conversations, which is why they don't behave identically.

This wasn't always how sign-in worked, either. Google phased out plain username-and-password logins for third-party apps like Mail between 2022 and 2024, moving everyone onto the same OAuth flow the Gmail app already used. If you find an older guide that shows a password field sitting directly inside Mail, it's describing a setup Google no longer offers.

Before you start#

A few things decide which version of this setup you'll actually see. Check these before you start so you're not troubleshooting a Workspace restriction that has nothing to do with your iPhone, or chasing a missing contact that was never going to sync on its own.

If the iPhone is enrolled in a company device-management profile — visible under Settings → General → VPN & Device Management — a Workspace admin may have already configured Gmail for you through that profile. Adding the same account manually on top of a managed profile is where a lot of 'why do I have two of everything' reports actually come from, so check there first if this is a work phone.

• Personal Gmail: only your email address and password — no app password, since the OAuth screen handles authentication for you.
• Google Workspace: works the same way unless an admin has restricted IMAP or third-party app access in the Google Admin Console, in which case Add Account fails immediately.
• Two-factor verification: adds one extra prompt on Google's sign-in screen; it doesn't change anything about the iPhone side of the setup.
• Re-adding an account: remove the old entry first (Settings → Mail → Accounts → the account → Delete Account) — two Gmail entries at once is the most common cause of mail appearing to duplicate.
• Large mailboxes: the first sync pulls metadata for every folder you enable, so years of mail takes noticeably longer on cellular than on Wi-Fi. It's a one-time cost, not an ongoing slowdown.
• iOS version: Add Account → Google has worked this exact way since iOS 15. The only real change since then is where Settings put the menu, not what the sign-in flow does — so a screenshot from a few years ago still gets you to the right place, just under a slightly different label.
• Manual IMAP, if you specifically need it: choosing Other instead of Google lets you type server details in directly — imap.gmail.com on port 993 (SSL) for incoming, smtp.gmail.com on port 587 (STARTTLS) for outgoing. That path needs an app password rather than your normal one, and an app password needs 2-Step Verification turned on first, so it's a longer road for the same result the Google option gets you in one screen.

How to add your Gmail account to iPhone Mail#

The exact labels shift a little by iOS version — Apple moved this menu under a new Apps section in iOS 26 — but the sequence of taps underneath has stayed the same for years. Follow whichever wording you actually see on screen; you're never more than one settings screen off from what's described here.

1. 1

   Open Settings → Mail → Accounts

   On iOS 26, that's Settings → Apps → Mail → Mail Accounts. On iOS 18 and earlier, it's Settings → Mail → Accounts. Tap Add Account.

2. 2

   Choose Google

   Pick Google specifically, not Other — Other routes you into a manual IMAP form that most people don't need and can get server settings wrong on.

3. 3

   Sign in through Google's page

   A system prompt appears first ('Settings Wants to Use google.com to Sign In'), then Google's own login form. Enter your address, your password, and your 2FA code if you use one. Workspace accounts with single sign-on may bounce through a company login page first — that's expected, and the flow finishes the same way once it hands control back to google.com.

4. 4

   Choose what to sync

   Toggle on Mail — and Contacts, Calendars or Notes if you want Google syncing those too — then tap Save.

5. 5

   Let the first sync finish

   A light inbox syncs in seconds; years of mail can take several minutes. Leave Mail open in the foreground rather than force-quitting it mid-sync. When it finishes, you'll see Gmail's own labels — Inbox, Starred, Sent, Drafts, All Mail, Spam, Trash — listed as folders under the account.

Apple Mail vs. the Gmail app: what's actually different#

The account works the same underneath either way — same inbox, same messages — but the two apps make different choices about how you interact with it. Two of the differences below are just habits to relearn; two of them are real problems with real fixes, covered next.

None of this makes one app objectively better. Apple Mail earns its keep by putting Gmail next to Outlook, iCloud or any other account in one inbox; the Gmail app earns its keep by keeping every Gmail-specific convenience intact.

One row above isn't a setting you can turn on, so it's worth explaining rather than just listing. Gmail's Primary, Social and Promotions tabs come from Gmail's own categorization system running on Google's servers, and that system was never exposed over IMAP. Apple Mail only ever sees the Inbox label as a single flat list, so mail that Gmail would normally route into Promotions or Social lands in the same Inbox as everything else.

That's a real usability trade-off, not a bug waiting for a fix — there's no hidden setting that brings Gmail's tabs into Apple Mail, because the tabs don't exist at the protocol level Apple Mail talks to.

Search inherits a version of the same limit. Gmail's own search runs against Google's index and understands things like sender reputation and past interactions; Apple Mail's search on an IMAP account queries the server directly, which is accurate but plainer, and can take noticeably longer across a mailbox with several years of history.

What to do when Gmail won't sync or notifications don't arrive#

The archive-versus-delete swipe has a real setting, not a workaround. Go to Settings → Mail → Accounts → your Gmail account → Account → Advanced, and look for Move Discarded Messages Into — it defaults to Archive Mailbox. Switch it to Deleted Mailbox and the same swipe gesture now deletes instead of archiving.

The All Mail folder isn't duplicating your messages — it's showing you the same underlying cause as the swipe setting. Gmail doesn't really have folders; it has labels, and IMAP exposes every label as its own folder, including the one that holds everything. If the clutter bothers you, open Gmail in a browser, go to Settings → See all settings → Labels, and turn off Show in IMAP for All Mail and any other label you don't need mirrored — just keep it on for Inbox, Sent, Drafts and Trash.

Gmail over IMAP does support push — Apple Mail keeps a live connection open so new mail should arrive close to instantly. When it doesn't, the usual cause on iPhone is Background App Refresh being turned off for Mail (Settings → General → Background App Refresh), or Low Power Mode throttling it, since every account you've added competes for the same budget. The Gmail app avoids this specific problem because it uses Google's own push infrastructure instead of sharing Mail's.

There's a second, separate setting worth checking: Settings → Mail → Accounts → Fetch New Data controls whether accounts use Push at all, or fall back to checking every 15 minutes, every hour, or only when you open Mail. It's a global setting shared by every account, so a Gmail-only sync issue is rarely caused by it — but if every account feels slow, not just Gmail, this is the first place to look before blaming Gmail specifically.

If mail stops arriving entirely rather than just lagging, the sign-in token has usually expired — that happens after a password change, a security alert on the Google account, or an admin revoking access on a Workspace domain. The fix is the same regardless of cause: delete the account (Settings → Mail → Accounts → the account → Delete Account) and add it back through Add Account → Google, which forces a fresh sign-in. For Workspace accounts specifically, if Add Account → Google fails the moment you enter the address, that's almost always an admin-level IMAP or third-party-access restriction — fixable in the Google Admin Console, not on the phone.

One more mismatch that looks like a sync problem but isn't: adding the account only turns on Mail unless you also toggle Contacts and Calendars during setup. If Google Contacts aren't showing up in the iPhone Contacts app, that's usually the reason — go back to Settings → Mail → Accounts → the account and switch Contacts on, since it doesn't follow Mail automatically.

One error message is worth naming specifically because it's misleading: 'Cannot Get Mail — The username or password for Gmail is incorrect.' That's the same expired-token problem described above, worded like a password mistake even though your actual Google password hasn't changed. Re-adding the account through Add Account → Google resolves it the same way, by forcing a fresh sign-in rather than asking you to guess at a password that was never wrong.

Drafts follow the same shared-label logic as everything else on this account. A draft you start in Apple Mail shows up in Gmail's own Drafts within a normal sync cycle, and the reverse is true too — there's no separate 'Apple Mail drafts' anywhere, because both apps are reading and writing the same Drafts label on Google's servers.

A faster way to handle every account, not just Gmail#

None of the behavior above is Gmail-specific — every account you add to Mail inherits the same swipe default, the same shared notification budget, the same one-account-at-a-time view. If the reason you're setting this up is that you're tired of an inbox that spans Gmail, Outlook and an IMAP account all behaving slightly differently, that's the exact problem an AI email assistant like AI Emaily is built to remove: the same triage, drafting and follow-up handling across every account instead of relearning quirks per provider.

We build AI Emaily. It connects to Gmail, Outlook, iCloud and generic IMAP with the same OAuth sign-in you just used for Mail, and a 7-day free trial gets you a real inbox to test rather than a demo account. The manual Mail setup above still works fine on its own — this is what doing the same thing continuously looks like once one account turns into five.