Short answer: If Mail won't open or freezes on your Mac, force quit it (Option-Command-Esc), restart the Mac and install any macOS update. If it still won't open, start up in safe mode to rule out other software, take a slow account offline, and rebuild the mailbox that hangs. As a last resort, Mail can rebuild its message index from scratch. If Mail opens but something else is wrong, such as sending, receiving or search, use the table below to jump to the right fix.
The steps are for macOS 27 and also work on macOS Tahoe 26, Sequoia 15 and Sonoma 14.
Mac Mail not working? Find your problem
| What you see | Where to start |
|---|---|
| Mail won't open, or bounces in the Dock and quits | This page: If Mail won't open, below |
| Mail freezes, shows the spinning wheel or stops responding | This page: If Mail freezes, below |
| Mail opens, then quits with an error | Mac Mail keeps crashing |
| Emails won't send | Mac Mail not sending emails |
| Messages stay in the Outbox | Messages stuck in the Outbox |
| New mail doesn't arrive | Mac Mail not receiving emails |
| The inbox doesn't refresh | Mac Mail inbox not updating |
| "Cannot connect to server" or an offline account | Mac Mail can't connect to the server |
| "Unable to verify account name or password" | Fix the password error |
| Emails won't delete | Mac Mail not deleting emails |
| Search finds nothing | Mac Mail search not working |
| Images or attachments don't show | Images or attachments guides |
The guides for each problem:
- Mac Mail keeps crashing
- Mac Mail not sending emails
- Messages stuck in the Outbox
- Mac Mail not receiving emails
- Mac Mail inbox not updating
- Mac Mail can't connect to the server
- Fix "Unable to verify account name or password"
- Mac Mail not deleting emails
- Mac Mail search not working
- Mac Mail not showing images
- Mac Mail not showing attachments
Mail opens but you suspect a wider outage? Check Apple System Status for iCloud Mail, or your provider's status page. If webmail works, the problem is on your Mac.
If Mail won't open
1. Force quit Mail and try again
Mail may still be running in the background even if no window shows. Press Option-Command-Esc (or choose Apple menu > Force Quit), select Mail and click Force Quit. Then open Mail from the Applications folder.
2. Restart your Mac and update macOS
A restart clears stuck background processes. Then check System Settings > General > Software Update: Mail is part of macOS, so fixes for it arrive as macOS updates. Mail problems often appear right after a big update and are fixed in the next point release.
3. Check free disk space
Mail needs room to update its database. If your startup disk is nearly full, Mail can hang at launch. Check System Settings > General > Storage and free some space.
4. Start up in safe mode
Safe mode loads macOS without third-party startup items and extensions, which shows whether other software is the problem.
- Mac with Apple silicon: shut down. Press and hold the power button until "Loading startup options" appears, select your startup disk, then press and hold Shift and click Continue in Safe Mode.
- Mac with an Intel processor: turn on or restart, and immediately hold Shift until the login window appears.
If Mail opens in safe mode, restart normally and remove recently added Mail plug-ins, VPNs or security apps one at a time. If it still won't open in safe mode, the problem is Mail's own data; go to step 5.
5. Let Mail rebuild its message index
Mail keeps an index of all your messages in a file called Envelope Index. If that file is damaged, Mail can fail to open. Apple doesn't document this fix, but it's widely used: move the index out of the way and Mail builds a new one.
- Quit Mail (force quit if needed).
- In Finder, choose Go > Go to Folder and enter ~/Library/Mail/V10/MailData. (V10 is still the folder on macOS 27.)
- Move every file whose name starts with Envelope Index to your Desktop. Don't delete them yet.
- Open Mail. It shows an import or rebuilding message and re-indexes your mail, which can take a long time for big mailboxes.
- Once Mail works and your mail looks right, you can delete the old files from the Desktop.
For IMAP, iCloud, Gmail and Exchange accounts your messages are on the server, so nothing is lost. If you use POP, back up the whole ~/Library/Mail folder first (Time Machine is fine).
6. Remove an account and add it back
If Mail opens only briefly before hanging, one account may be the trigger. Open System Settings > Internet Accounts (you don't need Mail open), turn Mail off for one account at a time, and try opening Mail after each. When you find the account, remove it and add it back with your provider's option.
If Mail freezes or stops responding
A spinning wheel usually means Mail is stuck waiting on a server or busy with a damaged mailbox. Work through these:
- Give it a minute. Right after you add an account or update macOS, Mail may be downloading and indexing thousands of messages. Window > Activity shows what it's doing.
- Force quit and reopen with Option-Command-Esc.
- Turn off your VPN or network filter and see whether Mail recovers. Apple names these as a common cause of connection problems.
- Take the slow account offline. Choose Mailbox > Online Status and take an account offline, or turn off Enable this account in Mail > Settings > Accounts > Account Information. If Mail stops freezing, that account is the problem.
- Rebuild the mailbox that hangs. If Mail freezes when you open a particular mailbox, select it and choose Mailbox > Rebuild. For IMAP and Exchange, Mail downloads its contents again from the server.
- Check the account's storage. Control-click the mailbox and choose Get Account Info. A mailbox at its limit can cause odd behavior.
- Remove and re-add the account as a last step.
If Mail doesn't freeze but quits with an error message, that's a crash rather than a hang, and the fixes are different: see Mac Mail keeps crashing.
If Mail keeps letting you down
Disclosure: we make Canary Mail. If you've worked through all of this and Mail is still unreliable, you might want a second app on hand. Canary Mail is an email app for Mac, iPhone, iPad, Windows and Android that works with Gmail, Outlook, iCloud, Yahoo, Exchange and other IMAP accounts. The free plan covers unlimited accounts on 2 devices with AI inbox sorting; the Growth plan ($36 a year) adds AI writing and summaries, read receipts and send later. More than 2 million people use it, and Apple has featured it on the App Store and the Mac App Store.
Be clear about what switching can't fix, though: if your provider is down, your password is wrong or your mailbox is full, every email app will hit the same wall.
Frequently asked questions
How do I reset Mail on my Mac?
Mail has no reset button. Removing an account and adding it back resets that account; moving the Envelope Index files out of ~/Library/Mail/V10/MailData makes Mail rebuild its index. Both keep mail stored on IMAP, iCloud, Gmail and Exchange servers.
Why is my Mail app not opening on my Mac?
Usually because Mail is stuck in the background, macOS needs an update, the disk is nearly full, other software conflicts with it, or its message index is damaged. Force quit, restart, update, then try safe mode.
Why does Mail keep freezing on my Mac?
Most freezes come from a slow or unreachable account, a VPN or network filter, or a damaged mailbox. Take accounts offline one at a time and rebuild the mailbox that hangs.
How do I force quit Mail on a Mac?
Press Option-Command-Esc, select Mail and click Force Quit. You can also choose Apple menu > Force Quit.
Is there a current problem with Apple Mail?
Check Apple's System Status page for iCloud Mail and your provider's status page for other accounts. If those are fine and webmail works, the problem is on your Mac.
Will I lose my emails if I rebuild Mail?
Not for IMAP, iCloud, Gmail or Exchange accounts: the messages are on the server and download again. POP mail is stored only on your Mac, so back it up first.
Sources
- Apple: If you can't send or receive email on Mac
- Apple: How to force an app to quit on your Mac
- Apple: Start up your Mac in safe mode
- Apple Mail User Guide: Create or delete mailboxes (Rebuild)
- Apple Mail User Guide (macOS Sequoia): Rebuild mailboxes
- Apple Mail User Guide: Add and manage email accounts
- Apple Mail User Guide: Change Account Information settings
- Apple: System Status
- Google Workspace Status Dashboard
- Microsoft: Service status