Apple Mail and Gmail: archiving, duplicates and labels
Updated October 2026
Gmail has labels, not folders, and Apple Mail sees every label as a folder. So a message with three labels shows up in three mailboxes, and Archive only works when Apple Mail's Archive Mailbox points at Gmail's All Mail. Check that in Mail › Settings › Accounts › Mailbox Behaviors, hide the labels you don't need in Gmail's settings, and let Gmail, not Mail, keep your sent mail.
Why it happens
In Gmail, every message lives in one place, All Mail, and labels are tags on it. Inbox is a label too, so archiving in Gmail just removes it. Mail apps that use IMAP, the standard way of reading mail, don't know about tags, so Google shows each label as a folder. Apple Mail is built around one message in one mailbox, and that's where the trouble starts.
- A message labeled Work and Receipts appears in Inbox, Work, Receipts and All Mail. It's one message in Gmail, but four in Apple Mail.
- Archive has to mean “take it out of Inbox, leave it in All Mail”, which isn't how folders work.
- Deleting a message from one label folder removes that label. The message itself stays in All Mail.
Make Archive work
- In Mail, choose Mail › Settings, then click Accounts and select your Gmail account.
- Click Mailbox Behaviors. Next to Archive Mailbox, choose All Mail, under your Gmail account.
- If archived mail keeps coming back to the Inbox, remove the account and add it again. That's the fix Mac users report working in this Apple Community thread.
To get Archive instead of Trash when you swipe or use a notification, go to Mail › Settings › Viewing and set “Move discarded messages into” to Archive. Apple notes that archiving a conversation archives only the messages in the mailbox you're in, not related ones elsewhere.
Fewer duplicates
- Hide labels you don't need: in Gmail on the web, go to Settings › See all settings › Labels and turn off “Show in IMAP” for labels you don't want as mailboxes in Mail, like Starred or Important. Leave All Mail on: hiding it can stop Archive from working.
- Let Gmail keep sent mail: Gmail files a copy of everything you send through it, and Google advises mail apps not to save another. If sent messages show up twice, look at Mailbox Behaviors › Sent Mailbox.
- Skip Mail's junk filter: Google sorts spam before it reaches Mail, and recommends not running a second filter on top.
- Very large mailboxes: if Mail is slow or keeps downloading, Gmail's Forwarding and POP/IMAP settings can limit how many messages each folder shows. Google suggests 10,000 or fewer.
Deleting
Where a deleted message goes depends on Mail › Settings › Accounts › Mailbox Behaviors › Trash Mailbox. When it points at Gmail's Trash, Delete moves the message there, and Gmail deletes it for good after 30 days. When deleted messages aren't moved to Trash, Gmail keeps them in All Mail, like an archive. Google recommends the second, so nothing gets lost by accident.
Google's recommended settings, in short
- Don't save sent messages on the server: Gmail already does.
- Save drafts on the server if you want them in Gmail on the web.
- Don't save deleted messages to Trash, unless you're fine with them being gone after 30 days.
- Don't turn on your mail app's junk filter.
The full list is on Google's page Choose your IMAP email client settings for Gmail.
A mail app that speaks Gmail
We make Lambda Mail, a Gmail app for Mac. It uses the same IMAP connection, plus the extensions Gmail adds to it so an app can see labels and conversations the way Gmail does. There's nothing to set up:
- Labels are labels: a message with three labels is one conversation with three labels, not three copies.
- Archive works like Gmail's: it takes the conversation out of the Inbox and leaves it in All Mail and its labels. An Archive mailbox shows what you've archived.
- No double sent mail: Gmail files the copy of what you send, and Lambda Mail doesn't save another.
- Gmail's search: type from:, has:attachment and the rest, as you would in Gmail.
Lambda Mail works with Gmail and Google Workspace on macOS 14 and later, and the beta is free.
More guides
Sources: Google, IMAP client settings for Gmail, Add Gmail to another email client and Gmail's IMAP extensions; Apple's Mail User Guide, Mailbox Behaviors settings and Archive emails (macOS 15 edition); Apple Community, archived Gmail returning to the Inbox (2023 to 2024); C-Command forum, hiding All Mail and Archive (February 2025).