{"code":"var Component=(()=>{var u=Object.create;var a=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var g=Object.getPrototypeOf,f=Object.prototype.hasOwnProperty;var b=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports),y=(t,e)=>{for(var n in e)a(t,n,{get:e[n],enumerable:!0})},s=(t,e,n,r)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let o of m(e))!f.call(t,o)&&o!==n&&a(t,o,{get:()=>e[o],enumerable:!(r=p(e,o))||r.enumerable});return t};var w=(t,e,n)=>(n=t!=null?u(g(t)):{},s(e||!t||!t.__esModule?a(n,\"default\",{value:t,enumerable:!0}):n,t)),x=t=>s(a({},\"__esModule\",{value:!0}),t);var h=b((M,l)=>{l.exports=_jsx_runtime});var k={};y(k,{default:()=>c});var i=w(h());function d(t){let e={a:\"a\",blockquote:\"blockquote\",code:\"code\",em:\"em\",h2:\"h2\",h3:\"h3\",img:\"img\",li:\"li\",ol:\"ol\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",ul:\"ul\",...t.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsxs)(e.p,{children:[\"You typed a sender's name into Mail's search field, hit Return, and the result list came back empty \\u2014 even though you can see that exact email two scrolls down in the message list. If \",(0,i.jsx)(e.strong,{children:\"Mac Mail search not working\"}),` has been driving you toward a full re-index, please stop for sixty seconds before you do anything destructive. On macOS Tahoe, the most common cause of \"Mail returns no results\" isn't a corrupted Envelope Index, a broken Spotlight database, or a stuck `,(0,i.jsx)(e.code,{children:\"mdworker\"}),\". It's a quiet behavioral change that Apple shipped with Tahoe and never highlighted in the release notes: Mail now defaults the search scope to \",(0,i.jsx)(e.strong,{children:\"the mailbox you currently have selected\"}),` rather than to \"All Mailboxes.\" A tiny chip labeled \"Search in: [Mailbox Name]\" appears just below the search field, and if you don't click it to switch to \"All,\" you are silently searching one folder while expecting global results.`]}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"MacBook displaying a glowing search field\",src:\"/images/blog/mac-mail-search-not-working-macos-tahoe-envelope-index-fix-2026/hero.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsxs)(e.p,{children:[`This guide leads with that Tahoe-specific behavioral fix because it resolves a majority of \"search broken\" reports we've seen since the 26.0 release, and it requires zero rebuilds. Once that's ruled out, we go deep on the real problems: a corrupted `,(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" in \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/\"}),', the Spotlight-Mail interdependence that controls full-text search, the persistent \"Indexing\\u2026\" status that stalls at the bottom of the window, IMAP server-side vs local-index search differences, smart-mailbox syntax pitfalls, attachment search edge cases, and a Terminal diagnostic (',(0,i.jsx)(e.code,{children:\"mdfind -onlyin\"}),\") that tells you in one command whether your messages are even reachable by Spotlight. If you also have general Mail trouble (won't send, won't receive, won't connect), see our companion piece on \",(0,i.jsx)(e.a,{href:\"/blog/mac-mail-not-working-complete-troubleshooting-fix-guide-2025\",children:\"Mail not working on Mac\"}),\" \\u2014 this article is strictly about search.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"key-takeaways\",children:\"Key Takeaways\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:'The #1 cause of Mail \"no results\" on Tahoe is the new scope chip'}),' \\u2014 Mail defaults search to the selected mailbox, not \"All Mailboxes.\" Click \"Search in: All\" before assuming the index is broken.']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsxs)(e.strong,{children:[\"The Envelope Index lives at \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/Envelope Index*\"})]}),\" on macOS Tahoe (V9 on Sonoma/Sequoia, V8 on Ventura). The controlled rebuild is: quit Mail, move the files to a backup folder, relaunch.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Mail search relies on Spotlight.\"}),\" If \",(0,i.jsx)(e.code,{children:\"Mail & Messages\"}),\" is unchecked in System Settings > Spotlight, or the Mail folder is in Spotlight Privacy, full-text and attachment search will silently fail.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:`A stuck \"Indexing\\u2026\" bar isn't always Mail's fault`}),\" \\u2014 it's usually Spotlight blocked by disk pressure, privacy exclusions, or a stalled \",(0,i.jsx)(e.code,{children:\"mdworker\"}),\" from the parent OS, not a Mail-specific bug.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"IMAP server-side search and local index search return different results.\"}),\" Knowing which one is active explains why some queries hit and others miss.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h2,{id:\"why-mac-mail-search-returns-nothing-on-macos-tahoe-start-here\",children:\"Why Mac Mail Search Returns Nothing on macOS Tahoe (Start Here)\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Before you touch the Envelope Index or anything in \",(0,i.jsx)(e.code,{children:\"~/Library\"}),', work through this section. About six out of ten \"Mail search is broken on Tahoe\" tickets we triage end here \\u2014 no rebuild required.']}),`\n`,(0,i.jsx)(e.h3,{id:\"the-tahoe-search-in-mailbox-scope-chip--the-hidden-culprit\",children:'The Tahoe \"Search in: [Mailbox]\" Scope Chip \\u2014 The Hidden Culprit'}),`\n`,(0,i.jsx)(e.p,{children:`In macOS Sonoma and earlier, Mail's search field had a behavior most users took for granted: type anything, hit Return, and Mail searched every mailbox on every account by default. You could narrow scope from a popover, but the default was \"everything.\"`}),`\n`,(0,i.jsxs)(e.p,{children:['Tahoe changed that default. When you click the search field while a specific mailbox is selected in the sidebar \\u2014 say, \"Inbox\" on your iCloud account, or a custom folder like \"Receipts 2025\" \\u2014 Mail now scopes the search to ',(0,i.jsx)(e.strong,{children:\"that mailbox only\"}),\". The visual cue is a small chip that appears immediately below the search field once you start typing. It reads:\"]}),`\n`,(0,i.jsxs)(e.blockquote,{children:[`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Search in: [Mailbox Name]\"}),\" \\u2715 \\xA0\\xA0\\xA0 \",(0,i.jsx)(e.strong,{children:\"All Mailboxes\"})]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:`The chip is intentional but visually quiet. The \"All Mailboxes\" suggestion sits to the right in a lower-contrast pill that's easy to miss against Tahoe's translucent toolbar background. If you don't click it, every search you run is restricted to whatever folder you happened to have highlighted when you started typing \\u2014 which is why searches for messages you \"know are there\" return zero results.`}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"macOS Mail search bar with scope chip highlighted\",src:\"/images/blog/mac-mail-search-not-working-macos-tahoe-envelope-index-fix-2026/content-1.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsx)(e.h3,{id:\"how-to-verify-which-scope-youre-in\",children:\"How to Verify Which Scope You're In\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsx)(e.li,{children:'Open Mail. Click any mailbox in the sidebar \\u2014 not \"All Inboxes,\" but a specific one like \"Inbox \\u2013 iCloud.\"'}),`\n`,(0,i.jsx)(e.li,{children:\"Click in the search field at the top of the window and type any common word (your own first name works).\"}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Look directly below the search field.\"}),` If you see \"Search in: [Mailbox Name]\" on the left, you're in scoped mode. To the right you'll see \"All Mailboxes.\"`]}),`\n`,(0,i.jsx)(e.li,{children:'Click \"All Mailboxes.\" The chip rewrites to \"Search in: All Mailboxes\" and the result list immediately repopulates with hits from every account.'}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:'If the result list jumps from \"No results\" to dozens or hundreds of matches the moment you click \"All Mailboxes,\" that was your entire problem. You can now stop reading and get on with your day. If results stay empty even after switching to \"All,\" continue to the Envelope Index section below.'}),`\n`,(0,i.jsx)(e.h3,{id:\"making-all-mailboxes-the-persistent-default\",children:'Making \"All Mailboxes\" the Persistent Default'}),`\n`,(0,i.jsx)(e.p,{children:`Mail remembers the last scope you used per-search-session, but it doesn't expose a global \"always search All Mailboxes\" preference in System Settings. There are two practical workarounds:`}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:'Select \"All Inboxes\" before searching.'}),' If the sidebar selection is already \"All Inboxes\" (the unified view), the scope chip defaults to All Mailboxes from the start. Get in the habit of clicking \"All Inboxes\" \\u2192 search field \\u2192 type.']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Use a Smart Mailbox.\"}),' Create a Smart Mailbox (Mailbox menu > New Smart Mailbox) with a permissive condition like \"Date Received is in the last 5 years\" and pin it to your favorites. Selecting it before searching forces an all-account scope by definition.']}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:\"Neither is as clean as restoring the pre-Tahoe default, and we expect Apple to add a preference in a point update once the feedback volume catches up. For now, awareness of the chip is the fix.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"quick-sanity-checks-before-going-deeper\",children:\"Quick Sanity Checks Before Going Deeper\"}),`\n`,(0,i.jsx)(e.p,{children:'If the scope chip is set correctly to \"All Mailboxes\" and search still returns nothing, do these three checks before opening Terminal:'}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Restart Mail completely.\"}),\" Cmd+Q (not just close the window), then relaunch. A surprising number of search hangs are an in-memory query state Mail forgets to clear.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Check the indexing status bar.\"}),' Look at the very bottom of the Mail window. If you see \"Indexing\\u2026\" with a moving counter, Mail is still building its search index. Searches against an unfinished index return partial or zero results. Wait for it to disappear before troubleshooting further.']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Try a single, unambiguous query.\"}),\" Search for your own email address. If that returns nothing across all mailboxes, your index really is broken and the next section applies.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h2,{id:\"the-envelope-index--what-it-is-and-how-to-rebuild-it-safely\",children:\"The Envelope Index \\u2014 What It Is and How to Rebuild It Safely\"}),`\n`,(0,i.jsx)(e.p,{children:\"If the scope chip is correct, indexing has finished, and Mail still returns no results for messages you can visibly see, the search database is corrupt. Here's how Mail's search index actually works and how to rebuild it without losing mail.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"where-the-envelope-index-lives-on-macos-tahoe-v10\",children:\"Where the Envelope Index Lives on macOS Tahoe (V10)\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Mail keeps its search index in a hidden SQLite database called \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\", plus a small set of write-ahead-log sidecar files. On macOS Tahoe the path is:\"]}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"M 6,1 C 4.354992,1 3,2.354992 3,4 v 16 c 0,1.645008 1.354992,3 3,3 h 12 c 1.645008,0 3,-1.354992 3,-3 V 8 7 A 1.0001,1.0001 0 0 0 20.707031,6.2929687 l -5,-5 A 1.0001,1.0001 0 0 0 15,1 h -1 z m 0,2 h 7 v 3 c 0,1.645008 1.354992,3 3,3 h 3 v 11 c 0,0.564129 -0.435871,1 -1,1 H 6 C 5.4358712,21 5,20.564129 5,20 V 4 C 5,3.4358712 5.4358712,3 6,3 Z M 15,3.4140625 18.585937,7 H 16 C 15.435871,7 15,6.5641288 15,6 Z\" fill=\"currentColor\" /></svg>',children:(0,i.jsxs)(e.code,{children:[(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"~/Library/Mail/V10/MailData/Envelope Index\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"~/Library/Mail/V10/MailData/Envelope Index-shm\"})}),`\n`,(0,i.jsx)(e.span,{className:\"line\",children:(0,i.jsx)(e.span,{children:\"~/Library/Mail/V10/MailData/Envelope Index-wal\"})})]})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"The \",(0,i.jsx)(e.code,{children:\"V10\"}),\" directory version is current as of macOS Tahoe. If you're on an older system or troubleshooting a friend's Mac, hedge: macOS Sonoma and Sequoia used \",(0,i.jsx)(e.code,{children:\"V9\"}),\", Ventura used \",(0,i.jsx)(e.code,{children:\"V8\"}),\", Monterey \",(0,i.jsx)(e.code,{children:\"V9\"}),\" (briefly), and older systems used \",(0,i.jsx)(e.code,{children:\"V5\"}),\" or \",(0,i.jsx)(e.code,{children:\"V6\"}),\". The pattern is the same \\u2014 only the version number changes. Open Finder, press Cmd+Shift+G, paste \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/\"}),\" and look at the highest-numbered \",(0,i.jsx)(e.code,{children:\"V*\"}),\" folder; that's the active one.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"The \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" file itself is the message metadata database \\u2014 sender, subject, date, mailbox membership, read state, flags. The \",(0,i.jsx)(e.code,{children:\"-shm\"}),\" (shared memory) and \",(0,i.jsx)(e.code,{children:\"-wal\"}),\" (write-ahead log) files are SQLite's transactional sidecars. All three must be moved together when you rebuild; leaving the WAL behind while removing the main file produces unpredictable results.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"Note that the \",(0,i.jsx)(e.strong,{children:\"full-text search index\"}),\" for message bodies and attachments is \",(0,i.jsx)(e.em,{children:\"not\"}),\" in \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\". That's Spotlight's job \\u2014 covered in the next section. \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" corruption affects header-based search (from, to, subject, date) and mailbox membership; Spotlight problems affect body and attachment search.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"the-controlled-rebuild-procedure\",children:\"The Controlled Rebuild Procedure\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Mail will rebuild a missing \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" automatically on next launch by re-reading every \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" file in \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/[Account UUID]/\"}),\". No mail is lost \\u2014 the actual messages live in the per-account folders, not in the index. The rebuild can take anywhere from five minutes to several hours depending on how many messages you have.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"Step by step:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Quit Mail completely.\"}),\" Cmd+Q. Verify with Activity Monitor that no \",(0,i.jsx)(e.code,{children:\"Mail\"}),' process is running. If it shows as \"Not Responding,\" force-quit (Cmd+Option+Esc).']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Open Finder and press Cmd+Shift+G.\"}),\" Paste this path and press Return: \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/\"})]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Create a backup folder on your Desktop\"}),\" called \",(0,i.jsx)(e.code,{children:\"Mail Index Backup [today's date]\"}),\".\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsxs)(e.strong,{children:[\"Drag every file whose name begins with \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" into the backup folder.\"]}),\" That's typically three files: \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\", \",(0,i.jsx)(e.code,{children:\"Envelope Index-shm\"}),\", \",(0,i.jsx)(e.code,{children:\"Envelope Index-wal\"}),\". Do not delete them yet \\u2014 if the rebuild fails, you'll want them back.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Relaunch Mail.\"}),` You'll see \"Importing messages\" at the bottom of the window, with a progress bar. Let it run uninterrupted. Closing your laptop lid or putting the machine to sleep mid-rebuild is the #1 cause of a half-built index that's worse than the original.`]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"When the import completes, test search.\"}),' Try a known query against \"All Mailboxes.\" If results return correctly, you can delete the Desktop backup folder after a week of clean operation. If results are still missing, restore the backed-up files (quit Mail first, drag them back, overwriting the new ones), and continue to the Spotlight section.']}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"how-to-tell-when-the-rebuild-is-actually-finished\",children:\"How to Tell When the Rebuild Is Actually Finished\"}),`\n`,(0,i.jsx)(e.p,{children:`The \"Importing messages\" status disappears when the per-account import completes, but Spotlight's content indexing of those rebuilt messages runs as a separate background pass. It's normal for header search (sender, subject, date) to start working within minutes of the rebuild, while body and attachment search lag for hours. If you test search immediately after the rebuild and see partial results, that's expected \\u2014 give Spotlight time to catch up.`}),`\n`,(0,i.jsxs)(e.p,{children:[\"You can monitor the Spotlight side by running \",(0,i.jsx)(e.code,{children:\"mdutil -s /\"}),\" in Terminal. Output like \",(0,i.jsx)(e.code,{children:\"Indexing enabled.\"}),\" with no progress percentage means the indexer has nothing pending. If it reports \",(0,i.jsx)(e.code,{children:\"Indexing in progress\"}),\", wait. For more aggressive monitoring, watch \",(0,i.jsx)(e.code,{children:\"mds\"}),\" and \",(0,i.jsx)(e.code,{children:\"mds_stores\"}),\" CPU usage in Activity Monitor \\u2014 when both drop to near-zero for an extended period, the import is genuinely done.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"what-to-do-if-the-rebuild-hangs\",children:\"What to Do If the Rebuild Hangs\"}),`\n`,(0,i.jsxs)(e.p,{children:['If \"Importing messages\" sits at the same count for more than thirty minutes with no progress, the rebuild is likely stuck on a corrupt ',(0,i.jsx)(e.code,{children:\".emlx\"}),\" file. Open Console.app, filter for \",(0,i.jsx)(e.code,{children:\"Mail\"}),\", and look for repeated errors mentioning a specific message UUID or file path. Move that single offending file out of its account folder to your Desktop, quit Mail, and relaunch. The import will resume past the broken message. We've seen rebuilds where a single 0-byte \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" file from a bad sync stalled the entire process.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"spotlight-and-mail--the-hidden-dependency\",children:\"Spotlight and Mail \\u2014 The Hidden Dependency\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Mail's search is a hybrid. Header fields (from, subject, date) come from the \",(0,i.jsx)(e.code,{children:\"Envelope Index\"}),\" SQLite database. Body text, attachment contents, and anything matched against the message payload come from \",(0,i.jsx)(e.strong,{children:\"Spotlight\"}),\". If Spotlight isn't indexing your Mail folder, Mail's full-text search silently degrades to header-only. That's why you might find a message by subject but not by a phrase quoted inside it.\"]}),`\n`,(0,i.jsxs)(e.h3,{id:\"how-mdworker-and-corespotlight-feed-mails-index\",children:[\"How \",(0,i.jsx)(e.code,{children:\"mdworker\"}),\" and \",(0,i.jsx)(e.code,{children:\"corespotlight\"}),\" Feed Mail's Index\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"When Mail saves a new message, it writes the \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" file under \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/[Account UUID]/[Mailbox].mbox/\"}),\". Spotlight's file system events daemon notices the new file and dispatches a \",(0,i.jsx)(e.code,{children:\"mdworker\"}),\" process to import it. The Mail importer plugin extracts the headers, body, and attachment text, hands them to \",(0,i.jsx)(e.code,{children:\"mds_stores\"}),\" (the Spotlight indexer), and from there the content is queryable through \",(0,i.jsx)(e.code,{children:\"mdfind\"}),\" and through Mail's search UI.\"]}),`\n`,(0,i.jsxs)(e.p,{children:[\"On macOS Tahoe, Apple consolidated some Mail indexing under the \",(0,i.jsx)(e.code,{children:\"corespotlight\"}),\" framework \\u2014 the same one used by third-party apps to expose searchable content. If \",(0,i.jsx)(e.code,{children:\"corespotlight\"}),\" is misbehaving system-wide (a known intermittent issue on Tahoe builds prior to 26.4), Mail's full-text search suffers along with everything else. We've written about \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-spotlight-freezing-corespotlight-fix-guide-2026\",children:\"Spotlight freezing on macOS Tahoe\"}),\" \\u2014 if your Mail full-text search is broken, that piece is worth reading alongside this one.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"verifying-spotlight-is-indexing-mail\",children:\"Verifying Spotlight Is Indexing Mail\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Open System Settings > Spotlight.\"}),' Scroll to \"Search results.\"']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:'Confirm \"Mail & Messages\" is checked.'}),\" If it's off, Mail content is excluded from Spotlight, and full-text search will return nothing.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:'Click \"Spotlight Privacy\" at the bottom.'}),\" Make sure neither \",(0,i.jsx)(e.code,{children:\"~/Library/Mail\"}),\" nor your home folder is listed as an excluded location. Anything on this list is invisible to the indexer.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Open System Settings > Privacy & Security > Full Disk Access.\"}),' Confirm that \"Mail\" and \"Spotlight\" (it appears as ',(0,i.jsx)(e.code,{children:\"mds\"}),\" or \",(0,i.jsx)(e.code,{children:\"mds_stores\"}),\" in some builds) have access. Without Full Disk Access, the indexer cannot read protected mail data.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:\"If any of these were off, fix them, then force a re-import of the Mail folder so the index rebuilds with the corrected permissions.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"forcing-a-mail-only-spotlight-re-import\",children:\"Forcing a Mail-Only Spotlight Re-Import\"}),`\n`,(0,i.jsx)(e.p,{children:\"Open Terminal and run:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mdimport\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -i\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mail/V10/MailData/\"})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"This tells Spotlight to re-import every file under \",(0,i.jsx)(e.code,{children:\"MailData/\"}),`, printing per-file diagnostic output. Watch for lines mentioning \"no importer\" or \"import failed\" \\u2014 those identify specific files Spotlight can't process. The full pass on a heavy mail archive can take an hour or more. Plug into power and don't sleep the Mac while it runs.`]}),`\n`,(0,i.jsx)(e.p,{children:\"To verify the import worked, run a one-message check:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mdimport\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -d2\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -t\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mail/V10/MailData/[Account\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" UUID]/[Mailbox].mbox/[some-message].emlx\"})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"Replace the bracketed parts with a real path. The \",(0,i.jsx)(e.code,{children:\"-d2\"}),\" flag prints verbose import details. If the output shows extracted body text and metadata, the importer is working. If it errors out, you've found a corrupt message or a broken importer plugin.\"]}),`\n`,(0,i.jsxs)(e.h3,{id:\"a-terminal-diagnostic-mdfind--onlyin\",children:[\"A Terminal Diagnostic: \",(0,i.jsx)(e.code,{children:\"mdfind -onlyin\"})]}),`\n`,(0,i.jsx)(e.p,{children:\"The single most useful Mail search diagnostic is one Terminal command:\"}),`\n`,(0,i.jsx)(i.Fragment,{children:(0,i.jsx)(e.pre,{className:\"shiki shiki-themes github-light github-dark\",style:{\"--shiki-light\":\"#24292e\",\"--shiki-dark\":\"#e1e4e8\",\"--shiki-light-bg\":\"#fff\",\"--shiki-dark-bg\":\"#24292e\"},tabIndex:\"0\",icon:'<svg viewBox=\"0 0 24 24\"><path d=\"m 4,4 a 1,1 0 0 0 -0.7070312,0.2929687 1,1 0 0 0 0,1.4140625 L 8.5859375,11 3.2929688,16.292969 a 1,1 0 0 0 0,1.414062 1,1 0 0 0 1.4140624,0 l 5.9999998,-6 a 1.0001,1.0001 0 0 0 0,-1.414062 L 4.7070312,4.2929687 A 1,1 0 0 0 4,4 Z m 8,14 a 1,1 0 0 0 -1,1 1,1 0 0 0 1,1 h 8 a 1,1 0 0 0 1,-1 1,1 0 0 0 -1,-1 z\" fill=\"currentColor\" /></svg>',children:(0,i.jsx)(e.code,{children:(0,i.jsxs)(e.span,{className:\"line\",children:[(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mdfind\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\" -onlyin\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Mail/V10\"}),(0,i.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:' \"search term here\"'})]})})})}),`\n`,(0,i.jsxs)(e.p,{children:[\"This asks Spotlight to find every file under your Mail data directory matching the term, with no UI in the way. If \",(0,i.jsx)(e.code,{children:\"mdfind\"}),\" returns hits but Mail's UI returns nothing, the index is fine and the problem is in Mail's UI layer (try the rebuild procedure above, or relaunch Mail). If \",(0,i.jsx)(e.code,{children:\"mdfind\"}),\" returns nothing for a term you know exists in your mail, Spotlight isn't indexing Mail at all \\u2014 go back to the Spotlight settings checks. For a broader Spotlight reset see our \",(0,i.jsx)(e.a,{href:\"/blog/spotlight-rebuild-guide-fix-search-not-working-2025\",children:\"Spotlight rebuild guide\"}),\".\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"the-stuck-indexing-status-bar\",children:'The Stuck \"Indexing\\u2026\" Status Bar'}),`\n`,(0,i.jsx)(e.p,{children:'The thin progress bar at the bottom of Mail labeled \"Indexing\\u2026\" is one of the most misunderstood UI elements in macOS. It does not mean Mail is broken. It means Mail is currently rebuilding all or part of its search index, and search results may be incomplete until it disappears.'}),`\n`,(0,i.jsx)(e.h3,{id:\"why-it-gets-stuck\",children:\"Why It Gets Stuck\"}),`\n`,(0,i.jsx)(e.p,{children:'When the \"Indexing\\u2026\" indicator persists for hours or days without finishing, one of these is almost always the cause:'}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Spotlight is paused or excluded.\"}),\" If your Mac is under disk pressure, Spotlight throttles or pauses. Free at least 15% of your boot volume.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"The Mail folder was recently added to Spotlight Privacy and then removed.\"}),' The transition can leave Spotlight in a \"needs rebuild\" state that takes a full pass to resolve.']}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"A FileVault encryption pass is in progress.\"}),\" Spotlight defers to encryption operations. Check System Settings > Privacy & Security > FileVault for status.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"An iCloud Mail sync is replacing messages faster than Spotlight can index them.\"}),\" This often happens after a Mac migration or restoring from Time Machine.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsxs)(e.strong,{children:[\"A stalled \",(0,i.jsx)(e.code,{children:\"mdworker_shared\"}),\" process.\"]}),\" Open Activity Monitor and search for \",(0,i.jsx)(e.code,{children:\"mdworker\"}),\". If one has been running for hours with no progress, force-quit it. The system will spawn a fresh one.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h3,{id:\"what-to-do-if-it-wont-finish\",children:\"What to Do If It Won't Finish\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Plug in power and leave the Mac awake overnight\"}),\" with Mail open. Most large-archive index passes complete in 6-12 hours.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Disable Low Power Mode.\"}),\" It throttles background indexing aggressively.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsxs)(e.strong,{children:[\"Check \",(0,i.jsx)(e.code,{children:\"mdutil -s /\"}),\".\"]}),' Run this in Terminal. If it reports \"Indexing enabled\" but no progress, run ',(0,i.jsx)(e.code,{children:\"sudo mdutil -E /\"}),\" to erase and rebuild the entire Spotlight index. Note this affects all search, not just Mail \\u2014 be ready for system-wide search to be incomplete for several hours.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"As a last resort, sign out of all Mail accounts, quit Mail, rebuild the Envelope Index (procedure above), and add the accounts back.\"}),\" This forces a clean re-download of message bodies and triggers a fresh Spotlight import.\"]}),`\n`]}),`\n`,(0,i.jsx)(e.h2,{id:\"per-account-search-imap-server-side-vs-local-index\",children:\"Per-Account Search: IMAP Server-Side vs Local Index\"}),`\n`,(0,i.jsx)(e.p,{children:\"A subtle source of confusion is that Mail uses two completely different search backends depending on which account you're searching.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"imap-server-side-search\",children:\"IMAP Server-Side Search\"}),`\n`,(0,i.jsx)(e.p,{children:\"When you search inside an IMAP account that is currently online (Gmail, iCloud, Fastmail, most corporate accounts), Mail can optionally hand the query to the server. The server runs the search across mail it has, including messages your local Mac may not have downloaded, and returns hits. Server-side search is fast and finds messages your local index doesn't know about \\u2014 but it uses the server's syntax, which often supports fewer operators than local search.\"}),`\n`,(0,i.jsx)(e.p,{children:'You can tell server-side search is being used by the small \"Search server\" indicator that appears in the result-list footer when querying an active IMAP folder. If you go offline mid-search, this option disappears.'}),`\n`,(0,i.jsx)(e.p,{children:(0,i.jsx)(e.img,{alt:\"macOS Mail sidebar mailbox list with one highlighted\",src:\"/images/blog/mac-mail-search-not-working-macos-tahoe-envelope-index-fix-2026/content-2.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,i.jsx)(e.h3,{id:\"local-index-search\",children:\"Local Index Search\"}),`\n`,(0,i.jsx)(e.p,{children:`When the account is offline, when you're searching a local \"On My Mac\" mailbox, or when you've explicitly chosen local-only search, Mail uses the Envelope Index plus Spotlight. This supports richer queries (boolean operators, date ranges, attachment-type filters) but only finds messages whose bodies have been downloaded and indexed.`}),`\n`,(0,i.jsx)(e.h3,{id:\"why-the-distinction-matters-for-no-results\",children:'Why the Distinction Matters for \"No Results\"'}),`\n`,(0,i.jsx)(e.p,{children:`If you search Gmail for a message you remember from 2018 and get nothing, it might be because (a) Gmail's server-side search ignores some local operators, (b) the message was archived to a label Mail doesn't have set as IMAP-visible, or (c) Mail is searching local cache only because the IMAP connection silently dropped. Pull down on the search results and look at the footer carefully \\u2014 if it says \"Search on server\" with a clickable button, click it and re-run the query. Many \"missing message\" complaints resolve at this step.`}),`\n`,(0,i.jsx)(e.h3,{id:\"pop3-and-exchange-differences\",children:\"POP3 and Exchange Differences\"}),`\n`,(0,i.jsx)(e.p,{children:\"POP3 accounts are local-only by definition; everything lives in the Envelope Index. Microsoft Exchange accounts (the protocol behind many corporate accounts) use a different server-search path \\u2014 Exchange Web Services \\u2014 that has its own quirks. If you use a work Exchange account and only its search is broken, the issue is usually a stale autodiscover record or expired OAuth token, not the local index. Re-add the account.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"smart-mailboxes-and-search-syntax\",children:\"Smart Mailboxes and Search Syntax\"}),`\n`,(0,i.jsx)(e.p,{children:\"Even after the index is healthy, the wrong query syntax produces empty results.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"when-to-use-a-smart-mailbox-instead-of-search\",children:\"When to Use a Smart Mailbox Instead of Search\"}),`\n`,(0,i.jsx)(e.p,{children:'If you find yourself running the same complex query (e.g., \"all unread mail from this client with attachments larger than 2 MB\"), build a Smart Mailbox instead. Mailbox menu > New Smart Mailbox. Smart Mailboxes are live queries \\u2014 they update as new mail arrives \\u2014 and they bypass the scope chip entirely because they have their own implicit scope (\"all accounts\" or whichever accounts you select).'}),`\n`,(0,i.jsx)(e.h3,{id:\"boolean-operators-and-field-modifiers\",children:\"Boolean Operators and Field Modifiers\"}),`\n`,(0,i.jsx)(e.p,{children:\"Local Mail search supports a small but useful query grammar:\"}),`\n`,(0,i.jsxs)(e.ul,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.code,{children:\"from:name\"}),\" \\u2014 limit to sender field\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.code,{children:\"to:name\"}),\" \\u2014 limit to recipient\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.code,{children:\"subject:phrase\"}),\" \\u2014 limit to subject line\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.code,{children:\"has:attachment\"}),\" \\u2014 only messages with attachments\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.code,{children:\"is:unread\"}),\", \",(0,i.jsx)(e.code,{children:\"is:flagged\"}),\" \\u2014 flag-based filters\"]}),`\n`,(0,i.jsxs)(e.li,{children:[\"Phrases in quotes are exact-match: \",(0,i.jsx)(e.code,{children:'\"quarterly report\"'}),\" returns only that exact string\"]}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:\"If you use these against an IMAP server-side search, only some may be honored \\u2014 Gmail accepts most, Exchange accepts fewer. When in doubt, pull the search local by temporarily disabling the account's online status, then re-run.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"date-range-queries\",children:\"Date-Range Queries\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"Mail accepts queries like \",(0,i.jsx)(e.code,{children:\"date:6/1/2026..6/4/2026\"}),\" for explicit ranges. Use the format the system's locale expects \\u2014 on a UK Mac that becomes \",(0,i.jsx)(e.code,{children:\"1/6/2026..4/6/2026\"}),\". Date queries always run locally; the server-side path doesn't accept this syntax.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"outlook-for-mac-vs-apple-mail-brief-note\",children:\"Outlook for Mac vs Apple Mail (Brief Note)\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"If you're searching in Microsoft Outlook for Mac rather than Apple Mail, none of the above applies. Outlook maintains its own search index in \",(0,i.jsx)(e.code,{children:\"~/Library/Group Containers/UBF8T346G9.Office/Outlook/\"}),`, and rebuilding it requires the \"Reset Outlook Search\" tool inside Outlook itself or rebuilding via the Microsoft Database Utility. The Envelope Index path doesn't exist for Outlook, and Spotlight indexes Outlook content through a separate Microsoft-provided importer. We mention this only because confusing the two leads people to delete the wrong files.`]}),`\n`,(0,i.jsx)(e.h2,{id:\"attachment-search-edge-cases\",children:\"Attachment Search Edge Cases\"}),`\n`,(0,i.jsx)(e.p,{children:\"Searching for text inside attachments is one of the most fragile parts of Mail search. Spotlight extracts text from PDFs, Word documents, plaintext files, and common image formats (via Live Text OCR on macOS Tahoe). Encrypted PDFs, password-protected ZIPs, scanned PDFs without OCR, and any file type Spotlight doesn't have an importer for are invisible to search.\"}),`\n`,(0,i.jsx)(e.p,{children:\"If you know a phrase exists inside an attachment but search misses it:\"}),`\n`,(0,i.jsxs)(e.ol,{children:[`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Open the attachment manually\"}),\" and confirm the text is selectable. If you can't select it (it's a flattened scan), Spotlight can't index it without OCR.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Check Live Text is enabled\"}),\" in System Settings > Language & Region > Live Text. On Tahoe, Live Text powers in-image text extraction for Spotlight.\"]}),`\n`,(0,i.jsxs)(e.li,{children:[(0,i.jsx)(e.strong,{children:\"Confirm the attachment was actually downloaded.\"}),' IMAP accounts can be set to leave attachments on the server. Mail menu > Preferences > Accounts > [Account] > Account Information > \"Download Attachments\" should be set to \"All.\"']}),`\n`]}),`\n`,(0,i.jsx)(e.p,{children:`For attachments that arrived years ago when \"Recent\" was the setting, you'll need to manually re-fetch them by opening the message and using \"Save Attachment\" \\u2014 that triggers a download that Spotlight will then index.`}),`\n`,(0,i.jsx)(e.h3,{id:\"image-attachments-and-live-text\",children:\"Image Attachments and Live Text\"}),`\n`,(0,i.jsx)(e.p,{children:\"On macOS Tahoe, Live Text extends Spotlight's reach into image attachments \\u2014 screenshots, photos of receipts, scanned documents shared as JPEGs. The OCR pass runs lazily on first preview rather than during the initial Mail import, which means the first time you preview an old image, Spotlight gets a chance to extract text and add it to the searchable index. If you've never opened an image, its contents may not be searchable yet.\"}),`\n`,(0,i.jsx)(e.p,{children:`A practical implication: after a major Mail import (account move, large archive restore), it's worth scrolling through your image-heavy folders to give Live Text the trigger it needs. This is one of the most overlooked reasons \"I know that screenshot is somewhere\" searches fail. It's not the Envelope Index \\u2014 the image was never OCR'd.`}),`\n`,(0,i.jsx)(e.h3,{id:\"encrypted-and-smime-messages\",children:\"Encrypted and S/MIME Messages\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"If you use S/MIME or PGP for some correspondence, those messages are stored encrypted in \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" files on disk. Mail decrypts them on demand for display, but Spotlight cannot index the encrypted ciphertext \\u2014 only metadata (sender, subject, date) ends up in the index. Searching for body text inside encrypted messages will always return nothing, regardless of how clean your Envelope Index is. This isn't a bug; it's the design intent of end-to-end encryption.\"]}),`\n`,(0,i.jsx)(e.p,{children:\"If you need to search inside encrypted mail, your only option is to open each message manually or use a third-party tool that decrypts and re-indexes locally with your private key. Apple Mail does not offer a built-in workaround.\"}),`\n`,(0,i.jsx)(e.h2,{id:\"troubleshooting-common-issues\",children:\"Troubleshooting Common Issues\"}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-search-returns-no-results-even-with-all-mailboxes-selected\",children:'Problem: Search returns no results even with \"All Mailboxes\" selected'}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" Confirm the indexing bar at the bottom of Mail isn't actively running. If it is, wait for it to finish. If indexing has completed and search still fails, rebuild the Envelope Index following the controlled procedure earlier in this guide. If the rebuild completes but search still fails, the problem has moved to Spotlight \\u2014 verify \",(0,i.jsx)(e.code,{children:\"Mail & Messages\"}),\" is enabled in System Settings > Spotlight and run \",(0,i.jsx)(e.code,{children:\"mdimport -i ~/Library/Mail/V10/MailData/\"}),\" in Terminal.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-only-header-search-works-body-text-returns-nothing\",children:\"Problem: Only header search works; body text returns nothing\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" This is the classic signature of a broken Spotlight integration. The Envelope Index is intact (so subjects and senders work) but Spotlight isn't reading message bodies. Check Spotlight Privacy for the Mail folder, confirm Mail & Messages is checked in Spotlight settings, and grant Full Disk Access to both Mail and \",(0,i.jsx)(e.code,{children:\"mds_stores\"}),\". Then re-import with \",(0,i.jsx)(e.code,{children:\"mdimport -i ~/Library/Mail/V10/MailData/\"}),\".\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-indexing-bar-at-the-bottom-never-disappears\",children:\"Problem: Indexing bar at the bottom never disappears\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" The system is stuck mid-import. Check Activity Monitor for \",(0,i.jsx)(e.code,{children:\"mdworker_shared\"}),\" processes \\u2014 if one has been pinned at high CPU for hours, kill it. Check \",(0,i.jsx)(e.code,{children:\"mdutil -s /\"}),\" in Terminal; if it reports issues, run \",(0,i.jsx)(e.code,{children:\"sudo mdutil -E /\"}),\" to erase and rebuild the Spotlight index. Make sure your disk has at least 15% free space and Low Power Mode is off.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-search-works-for-new-messages-but-not-for-old-ones\",children:\"Problem: Search works for new messages but not for old ones\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" Spotlight finished indexing recent mail before stalling on older archives. Run \",(0,i.jsx)(e.code,{children:\"mdimport -i ~/Library/Mail/V10/MailData/[Account UUID]/[Old Mailbox].mbox/\"}),\" against the specific archive folders. If individual \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" files in those folders are corrupt, the import will skip past them \\u2014 check Console for errors and quarantine bad files to your Desktop.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-server-side-imap-search-is-missing-recent-messages\",children:\"Problem: Server-side IMAP search is missing recent messages\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" The IMAP connection has likely dropped silently. Mailbox menu > Synchronize All Accounts forces a reconnect. If that doesn't restore search, take the account offline and back online (Mailbox menu > Take All Accounts Offline / Online). For Gmail-specific issues, verify the account's IMAP access is still enabled in your Google account settings.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-after-macos-tahoe-upgrade-all-search-behavior-changed\",children:\"Problem: After macOS Tahoe upgrade, all search behavior changed\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),` You're seeing the scope-chip behavior change described at the top of this guide. Mail now defaults to scoped-mailbox search rather than All Mailboxes. Click \"All Mailboxes\" in the chip below the search field every time you start a fresh query, or select \"All Inboxes\" in the sidebar before opening search.`]}),`\n`,(0,i.jsx)(e.h3,{id:\"problem-search-results-show-old-deleted-messages\",children:\"Problem: Search results show old, deleted messages\"}),`\n`,(0,i.jsxs)(e.p,{children:[(0,i.jsx)(e.strong,{children:\"Solution:\"}),\" The Envelope Index is out of sync with the actual mail store. Rebuild it using the controlled procedure. If deleted messages keep returning after a rebuild, you may have orphan \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" files left in the mailbox folder by a sync interruption \\u2014 these need to be cleaned manually or by re-syncing the affected mailbox from the server.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"faq\",children:\"FAQ\"}),`\n`,(0,i.jsx)(e.h3,{id:\"why-does-mail-search-work-in-some-folders-but-not-others-on-macos-tahoe\",children:\"Why does Mail search work in some folders but not others on macOS Tahoe?\"}),`\n`,(0,i.jsx)(e.p,{children:'This is almost always the Tahoe scope-chip behavior. When you click into a specific folder in the sidebar and then search, Mail restricts results to that folder by default. Click \"All Mailboxes\" in the chip that appears below the search field, and results from every account will populate. To avoid the issue, select \"All Inboxes\" in the sidebar before searching.'}),`\n`,(0,i.jsx)(e.h3,{id:\"is-rebuilding-the-envelope-index-safe-will-i-lose-mail\",children:\"Is rebuilding the Envelope Index safe? Will I lose mail?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"No mail is lost during a rebuild. The Envelope Index is only an index \\u2014 your actual messages are stored as individual \",(0,i.jsx)(e.code,{children:\".emlx\"}),\" files in per-account folders under \",(0,i.jsx)(e.code,{children:\"~/Library/Mail/V10/MailData/\"}),\". When you remove the index files, Mail rebuilds them on next launch by re-reading the messages. The only risk is interrupting the rebuild midway, so plug in to power and don't close the lid.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"how-long-should-a-full-envelope-index-rebuild-take\",children:\"How long should a full Envelope Index rebuild take?\"}),`\n`,(0,i.jsx)(e.p,{children:\"For a typical user with 10,000-50,000 messages, expect 10-30 minutes. For heavy users with 500,000+ messages spread across multiple accounts, it can take several hours. If your machine is on Apple Silicon with an SSD, expect the fast end of the range. Spinning disks (rare in 2026) and external mail stores will be significantly slower.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"whats-the-difference-between-v10-v9-and-older-mail-data-folders\",children:\"What's the difference between V10, V9, and older Mail data folders?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"The version number (V10 on Tahoe, V9 on Sonoma and Sequoia, V8 on Ventura) reflects Apple's internal data-format version. Each major macOS upgrade typically migrates the previous version forward, leaving the old folder in place. If you upgraded from Sonoma to Tahoe, you'll have both \",(0,i.jsx)(e.code,{children:\"V9\"}),\" and \",(0,i.jsx)(e.code,{children:\"V10\"}),\" folders \\u2014 only the highest-numbered one is active.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"can-i-exclude-certain-mailboxes-from-search-to-speed-it-up\",children:\"Can I exclude certain mailboxes from search to speed it up?\"}),`\n`,(0,i.jsx)(e.p,{children:\"Yes, indirectly: add the specific account folder to Spotlight Privacy in System Settings > Spotlight > Spotlight Privacy. Mail will continue to download messages but they won't be indexed for content search. Headers (from, to, subject, date) will still work because they come from the Envelope Index, which Spotlight Privacy doesn't affect.\"}),`\n`,(0,i.jsx)(e.h3,{id:\"does-using-icloud-mail-change-any-of-this\",children:\"Does using iCloud Mail change any of this?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"iCloud Mail uses IMAP under the hood and behaves like any other IMAP account for Mail search purposes. The Envelope Index and Spotlight integration are identical. The only iCloud-specific consideration is that iCloud's server-side search has slightly different behavior than Gmail's \\u2014 see our \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-icloud-drive-complete-guide-2025\",children:\"iCloud Drive guide\"}),\" for related sync details that can occasionally affect Mail availability.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"my-search-keyboard-shortcut-cmdoptionf-doesnt-work--is-that-related\",children:\"My search keyboard shortcut (Cmd+Option+F) doesn't work \\u2014 is that related?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"That's a shortcut issue, not an index issue. Check System Settings > Keyboard > Keyboard Shortcuts to confirm the binding hasn't been overridden by another app. On Tahoe, \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-spotlight-quick-keys-complete-guide-2026\",children:\"Spotlight quick keys\"}),\" introduced some keyboard handling changes that occasionally collide with Mail's defaults.\"]}),`\n`,(0,i.jsx)(e.h3,{id:\"if-i-have-other-mac-problems-beyond-mail-search-where-should-i-start\",children:\"If I have other Mac problems beyond Mail search, where should I start?\"}),`\n`,(0,i.jsxs)(e.p,{children:[\"If Mail won't send or receive at all (separate from search), the companion guide on \",(0,i.jsx)(e.a,{href:\"/blog/mac-mail-not-working-complete-troubleshooting-fix-guide-2025\",children:\"Mail not working on Mac\"}),\" is the place to start. If your whole Mac feels slow, multi-display issues might be at play \\u2014 see our piece on \",(0,i.jsx)(e.a,{href:\"/blog/windowserver-high-cpu-macos-tahoe-26-5-liquid-glass-multi-display-fix-2026\",children:\"WindowServer high CPU on Tahoe\"}),\". If iMessage is also acting up, \",(0,i.jsx)(e.a,{href:\"/blog/imessage-not-syncing-between-mac-and-iphone-macos-tahoe-fix-2026\",children:\"iMessage not syncing between Mac and iPhone\"}),\" covers the related continuity stack.\"]}),`\n`,(0,i.jsx)(e.h2,{id:\"conclusion\",children:\"Conclusion\"}),`\n`,(0,i.jsx)(e.p,{children:'Most \"Mac Mail search not working\" cases on macOS Tahoe come down to one of three things: the new scope chip silently restricting search to a single mailbox (the fastest fix), a corrupted Envelope Index that needs a controlled rebuild (an hour of patience, no mail lost), or a Spotlight integration problem that requires fixing permissions and re-importing the Mail folder. Work through them in that order before you reach for nuclear options like deleting and re-adding accounts.'}),`\n`,(0,i.jsx)(e.p,{children:`The behavioral change in Tahoe's search scope is genuinely confusing \\u2014 there's no announcement, no in-app tip, and the new default contradicts a decade of muscle memory. We expect Apple to either revert it or add a preference toggle in an upcoming point release; until then, the \"Search in: All Mailboxes\" chip is the most important UI element you'll ignore.`}),`\n`,(0,i.jsxs)(e.p,{children:[\"If your problems extend beyond search, we cover the broader space in detail: \",(0,i.jsx)(e.a,{href:\"/blog/mac-mail-not-working-complete-troubleshooting-fix-guide-2025\",children:\"general Mail troubleshooting\"}),\", \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-spotlight-freezing-corespotlight-fix-guide-2026\",children:\"Spotlight freezing on Tahoe\"}),\", and a \",(0,i.jsx)(e.a,{href:\"/blog/spotlight-rebuild-guide-fix-search-not-working-2025\",children:\"full Spotlight rebuild guide\"}),\" that goes deeper on the system-wide indexer than this article does. For Tahoe-era keyboard shortcuts that affect Mail search, see \",(0,i.jsx)(e.a,{href:\"/blog/macos-tahoe-spotlight-quick-keys-complete-guide-2026\",children:\"Spotlight quick keys on Tahoe\"}),\". Bookmark whichever of these match your symptoms \\u2014 Tahoe's quirks tend to overlap.\"]})]})}function c(t={}){let{wrapper:e}=t.components||{};return e?(0,i.jsx)(e,{...t,children:(0,i.jsx)(d,{...t})}):d(t)}return x(k);})();\n;return Component;","toc":[{"title":"Key Takeaways","url":"#key-takeaways","depth":2},{"title":"Why Mac Mail Search Returns Nothing on macOS Tahoe (Start Here)","url":"#why-mac-mail-search-returns-nothing-on-macos-tahoe-start-here","depth":2},{"title":"The Tahoe \"Search in: [Mailbox]\" Scope Chip — The Hidden Culprit","url":"#the-tahoe-search-in-mailbox-scope-chip--the-hidden-culprit","depth":3},{"title":"How to Verify Which Scope You're In","url":"#how-to-verify-which-scope-youre-in","depth":3},{"title":"Making \"All Mailboxes\" the Persistent Default","url":"#making-all-mailboxes-the-persistent-default","depth":3},{"title":"Quick Sanity Checks Before Going Deeper","url":"#quick-sanity-checks-before-going-deeper","depth":3},{"title":"The Envelope Index — What It Is and How to Rebuild It Safely","url":"#the-envelope-index--what-it-is-and-how-to-rebuild-it-safely","depth":2},{"title":"Where the Envelope Index Lives on macOS Tahoe (V10)","url":"#where-the-envelope-index-lives-on-macos-tahoe-v10","depth":3},{"title":"The Controlled Rebuild Procedure","url":"#the-controlled-rebuild-procedure","depth":3},{"title":"How to Tell When the Rebuild Is Actually Finished","url":"#how-to-tell-when-the-rebuild-is-actually-finished","depth":3},{"title":"What to Do If the Rebuild Hangs","url":"#what-to-do-if-the-rebuild-hangs","depth":3},{"title":"Spotlight and Mail — The Hidden Dependency","url":"#spotlight-and-mail--the-hidden-dependency","depth":2},{"title":"How mdworker and corespotlight Feed Mail's Index","url":"#how-mdworker-and-corespotlight-feed-mails-index","depth":3},{"title":"Verifying Spotlight Is Indexing Mail","url":"#verifying-spotlight-is-indexing-mail","depth":3},{"title":"Forcing a Mail-Only Spotlight Re-Import","url":"#forcing-a-mail-only-spotlight-re-import","depth":3},{"title":"A Terminal Diagnostic: mdfind -onlyin","url":"#a-terminal-diagnostic-mdfind--onlyin","depth":3},{"title":"The Stuck \"Indexing…\" Status Bar","url":"#the-stuck-indexing-status-bar","depth":2},{"title":"Why It Gets Stuck","url":"#why-it-gets-stuck","depth":3},{"title":"What to Do If It Won't Finish","url":"#what-to-do-if-it-wont-finish","depth":3},{"title":"Per-Account Search: IMAP Server-Side vs Local Index","url":"#per-account-search-imap-server-side-vs-local-index","depth":2},{"title":"IMAP Server-Side Search","url":"#imap-server-side-search","depth":3},{"title":"Local Index Search","url":"#local-index-search","depth":3},{"title":"Why the Distinction Matters for \"No Results\"","url":"#why-the-distinction-matters-for-no-results","depth":3},{"title":"POP3 and Exchange Differences","url":"#pop3-and-exchange-differences","depth":3},{"title":"Smart Mailboxes and Search Syntax","url":"#smart-mailboxes-and-search-syntax","depth":2},{"title":"When to Use a Smart Mailbox Instead of Search","url":"#when-to-use-a-smart-mailbox-instead-of-search","depth":3},{"title":"Boolean Operators and Field Modifiers","url":"#boolean-operators-and-field-modifiers","depth":3},{"title":"Date-Range Queries","url":"#date-range-queries","depth":3},{"title":"Outlook for Mac vs Apple Mail (Brief Note)","url":"#outlook-for-mac-vs-apple-mail-brief-note","depth":2},{"title":"Attachment Search Edge Cases","url":"#attachment-search-edge-cases","depth":2},{"title":"Image Attachments and Live Text","url":"#image-attachments-and-live-text","depth":3},{"title":"Encrypted and S/MIME Messages","url":"#encrypted-and-smime-messages","depth":3},{"title":"Troubleshooting Common Issues","url":"#troubleshooting-common-issues","depth":2},{"title":"Problem: Search returns no results even with \"All Mailboxes\" selected","url":"#problem-search-returns-no-results-even-with-all-mailboxes-selected","depth":3},{"title":"Problem: Only header search works; body text returns nothing","url":"#problem-only-header-search-works-body-text-returns-nothing","depth":3},{"title":"Problem: Indexing bar at the bottom never disappears","url":"#problem-indexing-bar-at-the-bottom-never-disappears","depth":3},{"title":"Problem: Search works for new messages but not for old ones","url":"#problem-search-works-for-new-messages-but-not-for-old-ones","depth":3},{"title":"Problem: Server-side IMAP search is missing recent messages","url":"#problem-server-side-imap-search-is-missing-recent-messages","depth":3},{"title":"Problem: After macOS Tahoe upgrade, all search behavior changed","url":"#problem-after-macos-tahoe-upgrade-all-search-behavior-changed","depth":3},{"title":"Problem: Search results show old, deleted messages","url":"#problem-search-results-show-old-deleted-messages","depth":3},{"title":"FAQ","url":"#faq","depth":2},{"title":"Why does Mail search work in some folders but not others on macOS Tahoe?","url":"#why-does-mail-search-work-in-some-folders-but-not-others-on-macos-tahoe","depth":3},{"title":"Is rebuilding the Envelope Index safe? Will I lose mail?","url":"#is-rebuilding-the-envelope-index-safe-will-i-lose-mail","depth":3},{"title":"How long should a full Envelope Index rebuild take?","url":"#how-long-should-a-full-envelope-index-rebuild-take","depth":3},{"title":"What's the difference between V10, V9, and older Mail data folders?","url":"#whats-the-difference-between-v10-v9-and-older-mail-data-folders","depth":3},{"title":"Can I exclude certain mailboxes from search to speed it up?","url":"#can-i-exclude-certain-mailboxes-from-search-to-speed-it-up","depth":3},{"title":"Does using iCloud Mail change any of this?","url":"#does-using-icloud-mail-change-any-of-this","depth":3},{"title":"My search keyboard shortcut (Cmd+Option+F) doesn't work — is that related?","url":"#my-search-keyboard-shortcut-cmdoptionf-doesnt-work--is-that-related","depth":3},{"title":"If I have other Mac problems beyond Mail search, where should I start?","url":"#if-i-have-other-mac-problems-beyond-mail-search-where-should-i-start","depth":3},{"title":"Conclusion","url":"#conclusion","depth":2}],"estimatedTime":26}