{"code":"var Component=(()=>{var u=Object.create;var o=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var m=Object.getPrototypeOf,y=Object.prototype.hasOwnProperty;var f=(i,e)=>()=>(e||i((e={exports:{}}).exports,e),e.exports),b=(i,e)=>{for(var t in e)o(i,t,{get:e[t],enumerable:!0})},r=(i,e,t,a)=>{if(e&&typeof e==\"object\"||typeof e==\"function\")for(let s of p(e))!y.call(i,s)&&s!==t&&o(i,s,{get:()=>e[s],enumerable:!(a=g(e,s))||a.enumerable});return i};var w=(i,e,t)=>(t=i!=null?u(m(i)):{},r(e||!i||!i.__esModule?o(t,\"default\",{value:i,enumerable:!0}):t,i)),v=i=>r(o({},\"__esModule\",{value:!0}),i);var l=f((S,h)=>{h.exports=_jsx_runtime});var M={};b(M,{default:()=>d});var n=w(l());function c(i){let e={a:\"a\",code:\"code\",em:\"em\",h2:\"h2\",h3:\"h3\",img:\"img\",li:\"li\",ol:\"ol\",p:\"p\",pre:\"pre\",span:\"span\",strong:\"strong\",ul:\"ul\",...i.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsxs)(e.p,{children:[\"You sent a message from your iPhone twenty minutes ago, you walk over to your Mac, open Messages, and the conversation is frozen in 2024. Or the inverse: you fired off a reply from your MacBook in a meeting, your iPhone never lit up, and now your friend thinks you ghosted them. \",(0,n.jsx)(e.strong,{children:\"iMessage not syncing\"}),\" between Mac and iPhone is one of the most persistent friction points in the entire Apple ecosystem, and on macOS Tahoe 26.5 / 26.5.1 it has taken on a new flavor because of how Apple has restructured the underlying Messages-in-iCloud pipeline and the Apple Account migration that shipped earlier in the Tahoe cycle.\"]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.img,{alt:\"Mac and iPhone with chat bubbles flowing between them\",src:\"/images/blog/imessage-not-syncing-between-mac-and-iphone-macos-tahoe-fix-2026/hero.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,n.jsx)(e.p,{children:'This guide walks the entire decision tree end to end. We will isolate which of the four distinct failure modes you are actually hitting, then apply the specific fix for that mode \\u2014 instead of the usual \"sign out and sign back in\" advice that solves the problem maybe one time in four and breaks something else the other three. By the end you should know exactly why your devices stopped agreeing, and exactly what to do about it.'}),`\n`,(0,n.jsx)(e.h2,{id:\"key-takeaways\",children:\"Key Takeaways\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"There are four distinct failure modes\"}),\", not one: Send & Receive mismatch, Messages in iCloud stalled, local \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" corruption on the Mac, and Apple Account drift between devices. The fix differs for each, so diagnosing the right mode first saves hours.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Send & Receive must match across devices\"}),' \\u2014 same Apple ID, same checked addresses, and the same \"Start new conversations from\" identity. A mismatch here is the single most common cause of iMessage not syncing on Tahoe.']}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Messages in iCloud is the canonical sync mechanism\"}),\" as of macOS Tahoe. If it is off on either device, the Mac and iPhone will diverge over time even if both are signed in.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsxs)(e.strong,{children:[\"Local \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" corruption\"]}),\" on the Mac side is rare but real, especially after forced shutdowns or a botched migration assistant import. A controlled reset (not a delete) fixes it.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Green-bubble SMS messages from Android contacts\"}),\" are not a sync bug \\u2014 they will not appear on your Mac unless SMS forwarding is on, and even then they are a different transport than iMessage.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.h2,{id:\"how-imessage-sync-actually-works-on-macos-tahoe\",children:\"How iMessage Sync Actually Works on macOS Tahoe\"}),`\n`,(0,n.jsx)(e.p,{children:\"Before we touch settings, you need a working mental model of the pipeline. iMessage on Tahoe rides on three layers stacked on top of each other, and a break in any single layer looks identical from the user's seat: messages stop syncing. The layers are not interchangeable.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"The first layer is the \",(0,n.jsx)(e.strong,{children:\"identity layer\"}),`. Every iMessage conversation is keyed to an Apple ID and a set of \"reachable at\" addresses (phone numbers and email addresses verified against that Apple ID). When you send an iMessage from your Mac, the Apple Push Notification service routes it based on the recipient's reachable addresses and your own outgoing identity. If your Mac and iPhone disagree about which identity you are using \\u2014 different Apple IDs, or the same Apple ID but a different set of checked addresses \\u2014 they end up on different \"sides\" of the conversation. The iPhone might think the conversation belongs to your phone number, while the Mac thinks it belongs to your iCloud email, and neither side will mirror the other.`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"The second layer is the \",(0,n.jsx)(e.strong,{children:\"delivery layer\"}),\", which is APNs (Apple Push Notification service) itself. When you send a message, Apple's servers fan it out to every device registered to your Apple ID that is currently reachable. This is why a fresh message can arrive on your Mac and iPhone simultaneously even with Messages in iCloud turned off. The delivery layer does not, however, replay history. It only delivers messages in real time.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"The third layer is the \",(0,n.jsx)(e.strong,{children:\"sync layer\"}),\", which is Messages in iCloud. This is what makes your message history, deletions, pinned conversations, and attachments converge across all your devices. Without Messages in iCloud, your Mac sees only what arrived via APNs while the Mac was awake, signed in, and online. If you bought a new MacBook last month, it would have no idea your iPhone has been in a five-year text thread with your sister \\u2014 there is no history to deliver because the delivery layer does not store any.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"On Tahoe specifically, Apple tightened the coupling between Messages in iCloud and the \",(0,n.jsx)(e.strong,{children:\"Advanced Data Protection\"}),\" flow. If you toggle ADP, Messages in iCloud has to re-key its CloudKit container, and during that re-keying window (which can last a few hours on a busy account) sync genuinely is paused. This is a normal, expected behavior, but it looks identical to a bug.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"the-apple-account-drift-problem\",children:\"The Apple Account Drift Problem\"}),`\n`,(0,n.jsxs)(e.p,{children:['The Apple Account (formerly \"Apple ID\") migration that landed mid-Tahoe introduced a subtle new failure mode. When Apple renamed the construct from Apple ID to Apple Account and consolidated some of the back-end identity tables, a small fraction of accounts ended up with what looks like one account but is actually two stitched-together records. Your Mac might be signed into the post-migration record while your iPhone is still pointing at the legacy record, or vice versa. On the surface both devices say \"Signed in as ',(0,n.jsx)(e.a,{href:\"mailto:you@example.com\",children:\"you@example.com\"}),'\" and look identical. Underneath, they are talking to different identity endpoints.']}),`\n`,(0,n.jsxs)(e.p,{children:[\"You can usually spot this by opening \",(0,n.jsx)(e.strong,{children:\"System Settings \\u2192 [Your Name] \\u2192 Sign-In & Security\"}),\" on the Mac and comparing the displayed Apple Account number to the one shown on the iPhone under \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 [Your Name] \\u2192 Sign-In & Security\"}),\". They should be identical strings of digits. If they differ \\u2014 even by one digit \\u2014 you have account drift and no amount of toggling Send & Receive will fix the underlying mismatch. You need to sign out of one device fully (System Settings \\u2192 Apple Account \\u2192 Sign Out, then restart), then sign back in.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"fast-diagnostic-decision-tree\",children:\"Fast Diagnostic Decision Tree\"}),`\n`,(0,n.jsx)(e.p,{children:\"Before you start mashing toggles, run this five-question triage. It takes about ninety seconds and will tell you which of the four failure modes you are in.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsxs)(e.strong,{children:[\"Question 1: Are \",(0,n.jsx)(e.em,{children:\"new\"}),\" messages from the last hour appearing on both devices?\"]})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:\"yes\"}),\", but older history is divergent \\u2192 you are in \",(0,n.jsx)(e.strong,{children:\"Mode B (Messages in iCloud)\"}),\". The delivery layer is healthy, but the sync layer is stalled or never finished its initial backfill.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:\"no\"}),\", only one device receives new messages \\u2192 continue to Question 2.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Question 2: When you send a new iMessage from the Mac, does it arrive on the iPhone at all (in any conversation)?\"})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:\"no\"}),\" to both \\u2192 you are in \",(0,n.jsx)(e.strong,{children:\"Mode A (Send & Receive mismatch)\"}),\" or \",(0,n.jsx)(e.strong,{children:\"Mode D (Apple Account drift)\"}),\". The Mac is not registering as a valid endpoint for your identity.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:'yes, but in a separate \"new\" thread instead of the existing conversation'}),\" \\u2192 you are in \",(0,n.jsx)(e.strong,{children:\"Mode A\"}),'. Your \"Start new conversations from\" address on the Mac differs from what the iPhone uses.']}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Question 3: Does the Messages app on the Mac launch normally, or does it spinning-beachball, hang, or crash within thirty seconds?\"})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"If it hangs, crashes, or shows empty conversation cells with broken thumbnails \\u2192 you are likely in \",(0,n.jsxs)(e.strong,{children:[\"Mode C (\",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" corruption)\"]}),\".\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Question 4: Did you recently change your iPhone SIM, switch to eSIM, change carriers, or port your phone number?\"})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:\"yes\"}),\" \\u2192 very likely \",(0,n.jsx)(e.strong,{children:\"Mode A\"}),'. Your phone number needs to be re-verified against your Apple ID before it will sync as a \"reachable at\" address.']}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Question 5: Did you recently sign out and back in on either device, restore from a backup, or run Migration Assistant in the last week?\"})}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"If \",(0,n.jsx)(e.strong,{children:\"yes\"}),\" \\u2192 check for \",(0,n.jsx)(e.strong,{children:\"Mode D (Apple Account drift)\"}),\" first. Migration events frequently leave devices on slightly different identity records.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:\"Now jump to the matching section below.\"}),`\n`,(0,n.jsx)(e.h2,{id:\"mode-a-send--receive-address-mismatch\",children:\"Mode A: Send & Receive Address Mismatch\"}),`\n`,(0,n.jsx)(e.p,{children:\"This is the single most common cause, and the fix is almost entirely in two settings panes \\u2014 one on each device.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.img,{alt:\"macOS Messages settings showing iMessage account toggles\",src:\"/images/blog/imessage-not-syncing-between-mac-and-iphone-macos-tahoe-fix-2026/content-1.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,n.jsx)(e.h3,{id:\"check-send--receive-on-your-mac\",children:\"Check Send & Receive on Your Mac\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Open \",(0,n.jsx)(e.strong,{children:\"Messages\"}),\" on your Mac. From the menu bar choose \",(0,n.jsx)(e.strong,{children:\"Messages \\u2192 Settings \\u2192 iMessage\"}),\". You should see, at minimum:\"]}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Apple Account\"}),\": This shows the Apple ID logged into iMessage. Note the exact email shown here \\u2014 this is critical.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"You can be reached for messages at\"}),\": A list of addresses with checkboxes. This should include your phone number (the one tied to your iPhone) and one or more email addresses.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Start new conversations from\"}),\": A dropdown that determines your \",(0,n.jsx)(e.em,{children:\"outgoing\"}),' identity. Whatever is selected here is what your recipients see as the \"From\" address.']}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Enable Messages in iCloud\"}),\": A checkbox we will return to in Mode B.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:'Now write down three things: the Apple Account email, the full set of checked \"reachable at\" addresses, and the \"Start new conversations from\" value.'}),`\n`,(0,n.jsx)(e.h3,{id:\"check-send--receive-on-your-iphone\",children:\"Check Send & Receive on Your iPhone\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"On the iPhone, open \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 Apps \\u2192 Messages \\u2192 Send & Receive\"}),\". (On older Tahoe-paired iOS versions this might be \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 Messages \\u2192 Send & Receive\"}),\" without the Apps intermediate level \\u2014 both routes land in the same place.)\"]}),`\n`,(0,n.jsx)(e.p,{children:\"You should see:\"}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Apple ID\"}),\" (still labeled this way on iOS for historical reasons, but it is the same Apple Account).\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"You can be reached by iMessage at\"}),\": a list of addresses with checkmarks.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Start new conversations from\"}),\": the outgoing identity dropdown.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:'Compare each line to what you wrote down from the Mac. They should match exactly, including the \"Start new conversations from\" value.'}),`\n`,(0,n.jsx)(e.h3,{id:\"why-start-new-conversations-from-matters-so-much\",children:'Why \"Start new conversations from\" Matters So Much'}),`\n`,(0,n.jsxs)(e.p,{children:[\"This is the setting users overlook the most. Suppose your iPhone is set to start new conversations from your phone number, and your Mac is set to start new conversations from your @icloud.com email. When you message a friend from the iPhone, the conversation is keyed to your phone number on Apple's servers. When you message that same friend later from the Mac, the Mac creates what looks like a \",(0,n.jsx)(e.em,{children:\"separate\"}),` conversation keyed to your email address. The friend sees both messages, but on your side the two devices show two different threads. From the user's perspective it looks like the Mac and iPhone are not syncing \\u2014 but technically they are, they just disagree about which conversation is \"the\" conversation.`]}),`\n`,(0,n.jsx)(e.p,{children:\"Fix it by setting the same value on both devices. Most people want to standardize on the phone number, because that is what their recipients usually have saved in contacts.\"}),`\n`,(0,n.jsx)(e.h3,{id:\"the-phone-number-not-reachable-issue\",children:'The \"Phone Number Not Reachable\" Issue'}),`\n`,(0,n.jsx)(e.p,{children:'After a SIM swap, eSIM transfer, carrier port, or even a long period without cellular service, your phone number can quietly fall off the \"reachable at\" list on one or both devices. iOS usually re-registers automatically, but the Mac sometimes does not pick up the change for hours or days.'}),`\n`,(0,n.jsxs)(e.p,{children:[\"To force the re-registration on the iPhone: \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 Apps \\u2192 Messages\"}),\", toggle \",(0,n.jsx)(e.strong,{children:\"iMessage\"}),` off, wait sixty seconds, toggle it back on, and wait for \"Waiting for activation\" to clear. You should now see your phone number with a checkmark in Send & Receive. If it stays in \"Waiting for activation\" for more than ten minutes, the activation server is bottlenecked or your carrier's SMS-verification path is broken; both are usually transient and self-clear within a few hours.`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"On the Mac, the equivalent flow is to sign out of iMessage entirely: \",(0,n.jsx)(e.strong,{children:\"Messages \\u2192 Settings \\u2192 iMessage \\u2192 Sign Out\"}),\". Quit Messages, wait a minute, relaunch, sign back in with the same Apple Account, and re-check the address list. Your phone number should reappear as a checked option within a few minutes of signing in.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"icloud-keychain-is-a-hard-dependency\",children:\"iCloud Keychain Is a Hard Dependency\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"One detail that catches a lot of users: iMessage activation on the Mac requires \",(0,n.jsx)(e.strong,{children:\"iCloud Keychain\"}),' to be enabled on at least one of your trusted devices. The activation flow uses Keychain to share the iMessage encryption keys across devices. If you previously disabled iCloud Keychain on every device, the Mac will fail activation silently and you will see \"Waiting for activation\" forever.']}),`\n`,(0,n.jsxs)(e.p,{children:[\"Re-enable iCloud Keychain on your iPhone (\",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 Passwords & Keychain\"}),\"), wait a minute for the Mac to notice, then redo the sign-out / sign-in dance on the Mac.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"mode-b-messages-in-icloud-stalled-or-disabled\",children:\"Mode B: Messages in iCloud Stalled or Disabled\"}),`\n`,(0,n.jsx)(e.p,{children:\"If new messages arrive on both devices but your history is divergent \\u2014 for example, the iPhone has a thread from 2022 but the Mac's copy of that thread starts in 2025 \\u2014 you are in Mode B. The sync layer is not doing its job.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.img,{alt:\"macOS Apple Account iCloud sync settings panel\",src:\"/images/blog/imessage-not-syncing-between-mac-and-iphone-macos-tahoe-fix-2026/content-2.webp\",width:\"2848\",height:\"1504\"})}),`\n`,(0,n.jsx)(e.h3,{id:\"confirm-messages-in-icloud-is-on-both-devices\",children:\"Confirm Messages in iCloud Is On (Both Devices)\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"On the \",(0,n.jsx)(e.strong,{children:\"iPhone\"}),\": \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 See All \\u2192 Messages in iCloud\"}),\". Toggle should be on. There is also a \",(0,n.jsx)(e.strong,{children:\"Sync Now\"}),\" button below the toggle \\u2014 tap it.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"On the \",(0,n.jsx)(e.strong,{children:\"Mac\"}),\": \",(0,n.jsx)(e.strong,{children:\"Messages \\u2192 Settings \\u2192 iMessage\"}),\", scroll down, check \",(0,n.jsx)(e.strong,{children:\"Enable Messages in iCloud\"}),\". Right next to that checkbox is a \",(0,n.jsx)(e.strong,{children:\"Sync Now\"}),\" button. Click it.\"]}),`\n`,(0,n.jsx)(e.p,{children:\"Both devices need the toggle on. If you enable it on a device for the first time, expect a backfill window of anywhere from ten minutes to several hours depending on the size of your message history and the speed of your network. During backfill, the Messages app on the new device will progressively populate threads and attachments. Do not interrupt this by signing out, force-quitting, or toggling the setting back off \\u2014 every interruption restarts the backfill from scratch.\"}),`\n`,(0,n.jsx)(e.h3,{id:\"what-messages-in-icloud-actually-syncs\",children:\"What Messages in iCloud Actually Syncs\"}),`\n`,(0,n.jsx)(e.p,{children:\"It is worth being explicit about scope, because misunderstandings here lead users to think Messages in iCloud is broken when it is working as designed:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Synced\"}),\": iMessage conversation history (text), attachments (images, videos, voice memos), reactions, pinned conversation order, message deletions (deletes propagate across devices), edits and unsends (within Apple's allowed window), read/unread state, and message search index.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Not synced\"}),': Notification settings (each device has its own), \"Filter Unknown Senders\" preference, message tone, the \"Send Read Receipts\" toggle (per-device), keyboard suggestions, and the SMS forwarding configuration itself (that lives on the iPhone). Also not synced: the ',(0,n.jsx)(e.em,{children:\"original\"}),\" SMS/MMS messages from before SMS forwarding was on, and any green-bubble messages that arrived while SMS forwarding was off.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.h3,{id:\"the-backfill-timeline\",children:\"The Backfill Timeline\"}),`\n`,(0,n.jsx)(e.p,{children:\"For a user with a few thousand messages, expect Mac backfill to complete in well under an hour. For a user with hundreds of thousands of messages across years of threads \\u2014 common for long-tenured iMessage users \\u2014 backfill can take six to twelve hours. The Messages app does not show a progress bar. The only signal is that threads keep getting older as the backfill walks backward in time.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"You can monitor backfill progress indirectly by watching \",(0,n.jsx)(e.strong,{children:\"System Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 Manage Account Storage \\u2192 Messages\"}),\". The reported storage usage will climb as attachments download. If the number stops climbing for more than thirty minutes during the day, sync has likely stalled \\u2014 proceed to the Sync Now button and, failing that, a controlled reset.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"the-storage-hit\",children:\"The Storage Hit\"}),`\n`,(0,n.jsx)(e.p,{children:\"This catches people off guard: Messages in iCloud counts against your iCloud storage quota. If you are on the 50 GB plan and your message history is 80 GB of attachments (mostly video and voice memos from group chats), Messages in iCloud will silently fail to sync attachments because there is no room. Text will sync, but the attachments will show as broken thumbnails on the Mac.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Check \",(0,n.jsx)(e.strong,{children:\"System Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 Manage Account Storage\"}),\" to see your free space. If you are within 10% of your limit, either delete some message attachments (long-press on an image in Messages \\u2192 More \\u2192 trash, which propagates the deletion across devices), free up other iCloud storage, or upgrade your iCloud+ plan.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"mode-c-chatdb-corruption-on-the-mac\",children:\"Mode C: chat.db Corruption on the Mac\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"This is rarer than the first two but absolutely a real failure mode, and you can spot it by these symptoms: Messages launches but conversations show blank, attachments show as broken icons, search returns no results even for words you can see on screen, the app spinning-beachballs on launch, or Console shows repeated entries from \",(0,n.jsx)(e.code,{children:\"chatkit\"}),\", \",(0,n.jsx)(e.code,{children:\"imagent\"}),\", or \",(0,n.jsx)(e.code,{children:\"IMDPersistence\"}),\" complaining about SQLite corruption.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"The Messages app stores all your local message data in three files in \",(0,n.jsx)(e.code,{children:\"~/Library/Messages/\"}),\":\"]}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"chat.db\"}),\" \\u2014 the main SQLite database containing message text, conversation metadata, and attachment references.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"chat.db-wal\"}),\" \\u2014 the SQLite write-ahead log. Pending writes that have not been merged into \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" yet live here.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.code,{children:\"chat.db-shm\"}),\" \\u2014 the SQLite shared-memory file used by the WAL mechanism.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:\"When the app shuts down cleanly, the WAL is merged into the main DB. When the app is force-quit, the Mac crashes, or the disk fills up mid-write, the WAL can end up in an inconsistent state. Messages then either refuses to open the DB at all, or opens it but can no longer reconcile it with the iCloud-synced state.\"}),`\n`,(0,n.jsx)(e.h3,{id:\"the-controlled-reset-procedure\",children:\"The Controlled Reset Procedure\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Do not delete \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\". Move it. The difference matters because if the iCloud sync re-pulls into a clean DB and something goes wrong, you want your old data on disk for recovery.\"]}),`\n`,(0,n.jsxs)(e.ol,{children:[`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Quit Messages completely\"}),\". Right-click the dock icon \\u2192 Quit. Then verify in Activity Monitor that no \",(0,n.jsx)(e.code,{children:\"Messages\"}),\", \",(0,n.jsx)(e.code,{children:\"imagent\"}),\", or \",(0,n.jsx)(e.code,{children:\"messagesappprivate\"}),\" processes are running. Kill any stragglers.\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Make a backup folder on the Desktop\"}),\":\"]}),`\n`,(0,n.jsx)(n.Fragment,{children:(0,n.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,n.jsx)(e.code,{children:(0,n.jsxs)(e.span,{className:\"line\",children:[(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mkdir\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Desktop/messages-backup-\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\"$(\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"date\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" +%Y%m%d\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#24292E\",\"--shiki-dark\":\"#E1E4E8\"},children:\")\"})]})})})}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Move the three database files\"}),\" (not copy \\u2014 move, so the next launch creates fresh ones):\"]}),`\n`,(0,n.jsx)(n.Fragment,{children:(0,n.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,n.jsxs)(e.code,{children:[(0,n.jsxs)(e.span,{className:\"line\",children:[(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mv\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Messages/chat.db\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Desktop/messages-backup-\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"*\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"/\"})]}),`\n`,(0,n.jsxs)(e.span,{className:\"line\",children:[(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mv\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Messages/chat.db-wal\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Desktop/messages-backup-\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"*\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"/\"})]}),`\n`,(0,n.jsxs)(e.span,{className:\"line\",children:[(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#6F42C1\",\"--shiki-dark\":\"#B392F0\"},children:\"mv\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Library/Messages/chat.db-shm\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\" ~/Desktop/messages-backup-\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#005CC5\",\"--shiki-dark\":\"#79B8FF\"},children:\"*\"}),(0,n.jsx)(e.span,{style:{\"--shiki-light\":\"#032F62\",\"--shiki-dark\":\"#9ECBFF\"},children:\"/\"})]})]})})}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Launch Messages\"}),\". The app will create a fresh, empty local database.\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"If Messages in iCloud is on\"}),\", the app will now begin backfilling from iCloud. Expect the same backfill timeline described in Mode B.\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"If Messages in iCloud is off\"}),\", you have just lost your local history on the Mac \\u2014 but it should still exist on the iPhone. Turn on Messages in iCloud on both devices and let the iPhone push history into iCloud, then let the Mac pull it back down.\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.li,{children:[`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"After you confirm Messages is working and history has backfilled\"}),\", you can delete the backup folder. Until then, keep it.\"]}),`\n`]}),`\n`]}),`\n`,(0,n.jsx)(e.h3,{id:\"when-the-controlled-reset-is-not-enough\",children:\"When the Controlled Reset Is Not Enough\"}),`\n`,(0,n.jsx)(e.p,{children:\"If after a controlled reset Messages still crashes or hangs, the corruption may extend into your CloudKit-side Messages container. The fix here is to disable and re-enable Messages in iCloud, which forces a clean re-sync:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[\"On the iPhone: \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 See All \\u2192 Messages in iCloud \\u2192 toggle off\"}),\". iOS will ask whether to keep messages on this device \\u2014 choose \",(0,n.jsx)(e.strong,{children:\"Disable and Download Messages\"}),\", so your iPhone retains its copy.\"]}),`\n`,(0,n.jsx)(e.li,{children:\"Wait two minutes.\"}),`\n`,(0,n.jsx)(e.li,{children:\"Toggle Messages in iCloud back on.\"}),`\n`,(0,n.jsx)(e.li,{children:\"On the Mac, also toggle it off and then back on.\"}),`\n`,(0,n.jsx)(e.li,{children:\"Let the backfill complete.\"}),`\n`]}),`\n`,(0,n.jsx)(e.h2,{id:\"mode-d-apple-account-drift\",children:\"Mode D: Apple Account Drift\"}),`\n`,(0,n.jsx)(e.p,{children:\"Diagnosed via the Apple Account number comparison described in the architecture section above. The fix is to fully sign out of one device and sign back in, which forces it to re-register against the canonical post-migration record.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"Pick the device that is \",(0,n.jsx)(e.em,{children:\"less\"}),\" recently used (you have less to lose if something goes sideways). On that device:\"]}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"iPhone\"}),\": \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 [Your Name] \\u2192 Sign Out\"}),\". Choose to keep a copy of your data on the device. Restart the iPhone. Sign back in with the same Apple Account.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Mac\"}),\": \",(0,n.jsx)(e.strong,{children:\"System Settings \\u2192 [Your Name] \\u2192 Sign Out\"}),\". Pick which iCloud data to keep a local copy of (Messages, Photos, etc.). Restart. Sign back in.\"]}),`\n`]}),`\n`,(0,n.jsx)(e.p,{children:\"After sign-back-in, recheck Send & Receive (Mode A) and Messages in iCloud (Mode B). The new sign-in should put both devices on the same identity record, and the symptoms should clear within an hour or two.\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"For broader Continuity issues that often share root causes with iMessage drift, the \",(0,n.jsx)(e.a,{href:\"/blog/macos-tahoe-continuity-features-complete-troubleshooting-guide-2025\",children:\"Continuity features troubleshooting guide\"}),\" and the focused \",(0,n.jsx)(e.a,{href:\"/blog/macos-tahoe-continuity-sync-troubleshooting-complete-guide-2025\",children:\"Continuity sync troubleshooting guide\"}),\" walk through the parallel diagnostics for Handoff, Universal Clipboard, and AirDrop.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"the-sms-from-android-gotcha\",children:\"The SMS-from-Android Gotcha\"}),`\n`,(0,n.jsx)(e.p,{children:`This is the most common false positive. A user reports \"iMessage not syncing \\u2014 my Android friend's messages don't show up on my Mac.\" The friend texts a green bubble (because they are on Android, so iMessage is not in play), the iPhone receives it as an SMS, and the Mac shows nothing.`}),`\n`,(0,n.jsx)(e.p,{children:\"This is not an iMessage sync bug. It is the SMS Forwarding feature working as designed \\u2014 or rather, not configured.\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"SMS messages cannot be iMessages.\"}),\" They are a fundamentally different transport: cellular SMS/MMS to your phone number. The way Apple bridges them to your Mac is \",(0,n.jsx)(e.strong,{children:\"Text Message Forwarding\"}),\", a feature on the iPhone that pipes your incoming SMS/MMS over to your other Apple devices via iMessage's relay infrastructure. If SMS forwarding is off, green-bubble messages will \",(0,n.jsx)(e.em,{children:\"never\"}),\" appear on your Mac, even if everything else is configured correctly.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"To enable: on the iPhone, \",(0,n.jsx)(e.strong,{children:\"Settings \\u2192 Apps \\u2192 Messages \\u2192 Text Message Forwarding\"}),\". Toggle on each device you want to receive SMS on. The Mac will display a six-digit code to enter on the iPhone as a one-time verification.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[\"Note that this is also distinct from the new \",(0,n.jsx)(e.strong,{children:\"RCS messaging\"}),\" support that landed alongside Tahoe. RCS is a separate cellular-based protocol that supersedes SMS for messages between iPhone and modern Android phones. If your RCS messages specifically are failing to send (not failing to \",(0,n.jsx)(e.em,{children:\"sync\"}),\" \\u2014 failing to \",(0,n.jsx)(e.em,{children:\"send\"}),\"), the diagnostic path is entirely different; see the \",(0,n.jsx)(e.a,{href:\"/blog/rcs-message-send-failure-macos-26-5-mac-ipad-watch-fix-2026\",children:\"RCS message send failure on macOS 26.5 guide\"}),\" because that is a cellular-gate problem, not a Mac-iPhone iCloud sync problem.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"what-to-do-if-old-messages-exist-on-iphone-but-not-mac\",children:\"What to Do If Old Messages Exist on iPhone but Not Mac\"}),`\n`,(0,n.jsx)(e.p,{children:\"This is the most common Mode B variant and deserves a dedicated walkthrough because the user expectation often does not match Apple's design.\"}),`\n`,(0,n.jsx)(e.p,{children:'The default assumption is: \"I just turned on Messages in iCloud on my Mac, so my Mac should now show every message I have ever received.\" That is the eventual outcome, but it can take a long time and there is no progress UI.'}),`\n`,(0,n.jsx)(e.p,{children:\"The expected timeline is:\"}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Minutes 0\\u20135\"}),\": New messages from this point on sync in real time.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Minutes 5\\u201360\"}),\": The most recent week to month of history backfills.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Hours 1\\u20136\"}),\": The last year of history backfills.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.strong,{children:\"Hours 6\\u201324\"}),\": The full multi-year history backfills, including older attachments.\"]}),`\n`]}),`\n`,(0,n.jsxs)(e.p,{children:[\"If after 24 hours of the Mac being awake, online, and signed in, you still have a clearly missing chunk of history, then sync is genuinely stuck. The fix is the toggle-off-and-on dance on both devices, optionally followed by the controlled \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" reset.\"]}),`\n`,(0,n.jsxs)(e.p,{children:['A second cause of \"old messages on iPhone but not Mac\" is that the ',(0,n.jsx)(e.strong,{children:\"iPhone's local message history is longer than what is stored in iCloud\"}),\". If you have ever had Messages in iCloud disabled on the iPhone, those messages were never pushed to iCloud, and they will not show up on the Mac even after enabling Messages in iCloud \\u2014 because they only exist on the iPhone. To push them up, ensure Messages in iCloud is \",(0,n.jsx)(e.em,{children:\"enabled\"}),\" on the iPhone (not just on the Mac), and tap Sync Now.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"troubleshooting-common-issues\",children:\"Troubleshooting Common Issues\"}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-waiting-for-activation-wont-clear-on-the-mac\",children:`Problem: \"Waiting for Activation\" Won't Clear on the Mac`}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),': Quit Messages, sign out of iCloud entirely (System Settings \\u2192 Apple Account \\u2192 Sign Out), restart the Mac, sign back in, then re-enable iMessage from Messages \\u2192 Settings. The \"Waiting for activation\" state often persists when there is a stale token cached in Keychain that a full iCloud sign-out clears. If it still fails after a full sign-out and the iPhone activates fine, your account may be flagged for rate-limiting on the activation server \\u2014 wait 24 hours and try again.']}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-new-messages-sync-but-deletions-dont\",children:\"Problem: New Messages Sync but Deletions Don't\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": This is almost always a Messages in iCloud problem. Deletions only propagate when both devices have Messages in iCloud on. Verify the toggle on both, and tap Sync Now on whichever device you deleted from. If you deleted from a device that did not have Messages in iCloud on, the deletion will not propagate \\u2014 you will need to manually delete again from a device that does have it on.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-attachments-are-missing-or-show-as-broken-thumbnails\",children:\"Problem: Attachments Are Missing or Show as Broken Thumbnails\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": Check iCloud storage quota first (System Settings \\u2192 [Your Name] \\u2192 iCloud \\u2192 Manage Account Storage). If you are over quota, attachment sync silently fails. If quota is fine, the attachments may simply still be downloading \\u2014 Messages backfills attachments lazily after text. Click on a broken thumbnail to force an immediate download. If it still fails, the controlled \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" reset usually fixes it.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-messages-app-hangs-for-30-seconds-on-launch\",children:\"Problem: Messages App Hangs for 30 Seconds on Launch\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": This is almost always WAL replay on a large, fragmented \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\". Either wait it out (it will eventually complete and run faster next launch), or apply the controlled reset. If hangs persist after a reset, check Disk Utility \\u2192 First Aid on your boot volume \\u2014 slow disk reads can manifest as a hung Messages app.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-mac-shows-messages-from-one-conversation-in-two-threads\",children:\"Problem: Mac Shows Messages from One Conversation in Two Threads\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),': Classic Send & Receive mismatch. Both threads exist because the Mac is keying conversations by a different \"Start new conversations from\" identity than the iPhone. Standardize the setting on both devices (usually to the phone number), then expect a few days for the merge to settle \\u2014 Apple does not retroactively merge split threads, but new messages will land in whichever thread matches the canonical identity going forward.']}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-group-chats-sync-but-one-on-ones-dont-or-vice-versa\",children:\"Problem: Group Chats Sync but One-on-Ones Don't (or Vice Versa)\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": This usually points to a contact-level address mismatch. Open the misbehaving conversation, tap the contact name, and check the address you are messaging them at. If you are messaging their phone number from one device and their email from another, Apple treats those as different conversations. Standardize on one address \\u2014 preferably the one shown in the existing thread on whichever device has the most history.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-mac-mail-also-stopped-working-at-the-same-time\",children:\"Problem: Mac Mail Also Stopped Working at the Same Time\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": This points to a broader Apple Account / iCloud issue, not specifically iMessage. The \",(0,n.jsx)(e.a,{href:\"/blog/mac-mail-not-working-complete-troubleshooting-fix-guide-2025\",children:\"Mac Mail troubleshooting guide\"}),\" walks through the parallel diagnostics. If Mail search specifically is broken, the \",(0,n.jsx)(e.a,{href:\"/blog/mac-mail-search-not-working-macos-tahoe-envelope-index-fix-2026\",children:\"envelope index repair guide\"}),\" covers the Mail-specific equivalent of the \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" reset described above.\"]}),`\n`,(0,n.jsx)(e.h3,{id:\"problem-icloud-drive-is-also-behaving-oddly\",children:\"Problem: iCloud Drive Is Also Behaving Oddly\"}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Solution\"}),\": Check the \",(0,n.jsx)(e.a,{href:\"/blog/icloud-drive-auto-download-bug-macos-tahoe-26-4-fix-2026\",children:\"iCloud Drive auto-download bug guide\"}),\". Multiple iCloud services going sideways at once usually means a daemon-level issue (\",(0,n.jsx)(e.code,{children:\"cloudd\"}),\" or \",(0,n.jsx)(e.code,{children:\"bird\"}),\") rather than an app-level one. The fix paths overlap.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"faq\",children:\"FAQ\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: Will I lose my message history if I sign out of iMessage on the Mac?\"})}),`\n`,(0,n.jsxs)(e.p,{children:[\"No, provided Messages in iCloud is enabled. Your history is stored in iCloud and will re-download when you sign back in. If Messages in iCloud is off, the local \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" on the Mac will be preserved through the sign-out, so signing back in with the same Apple Account will restore the same local history. The risky case is signing out without iCloud and then signing in with a different Apple Account.\"]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: How long should a fresh Messages in iCloud backfill take on a new Mac?\"})}),`\n`,(0,n.jsx)(e.p,{children:\"Typically thirty minutes to two hours for a few thousand messages, but multi-year heavy users can see twelve to twenty-four hours for full backfill including attachments. There is no progress UI \\u2014 the only signal is that threads keep getting older as the sync walks backward in time. Keep the Mac awake, online, and signed in throughout. Sleep mode pauses backfill.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: Why do messages from my Android friend never sync to my Mac?\"})}),`\n`,(0,n.jsx)(e.p,{children:\"Because those are SMS messages, not iMessages, and SMS is a cellular protocol that does not natively reach your Mac. You need to enable Text Message Forwarding on your iPhone (Settings \\u2192 Apps \\u2192 Messages \\u2192 Text Message Forwarding) and add your Mac as a destination. Once enabled, future green-bubble SMS messages will forward to the Mac. Historical SMS messages received before forwarding was enabled will not retroactively appear.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: Is Messages in iCloud the same as iCloud Backup?\"})}),`\n`,(0,n.jsx)(e.p,{children:\"No, they are separate systems. iCloud Backup is a per-device snapshot of your iPhone's state. Messages in iCloud is a live, multi-device synced store of your message history. You can have one without the other. Disabling iCloud Backup does not affect Messages in iCloud, and vice versa. Both, however, share your iCloud storage quota.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: Does Messages in iCloud sync to a Windows PC or web browser?\"})}),`\n`,(0,n.jsx)(e.p,{children:\"No. There is no web interface for Messages and no Windows client. Messages in iCloud only syncs across Apple devices \\u2014 iPhone, iPad, Mac, and Apple Watch (the Watch shows messages but does not store full history). If you need cross-platform access to message content, you would need to manually export, which is not a first-class workflow.\"}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:`Q: Why does my iPhone show \"Last seen\" times that don't match my Mac?`})}),`\n`,(0,n.jsx)(e.p,{children:'Read receipts and presence indicators are per-device settings, not synced. If \"Send Read Receipts\" is on for the Mac but off for the iPhone (or vice versa), the two devices will report different states to the other party. To unify behavior, set the same Read Receipts preference on every device, in Messages \\u2192 Settings \\u2192 iMessage on the Mac and Settings \\u2192 Apps \\u2192 Messages on the iPhone.'}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: I have iPhone Mirroring set up \\u2014 shouldn't that solve the syncing problem?\"})}),`\n`,(0,n.jsxs)(e.p,{children:[\"iPhone Mirroring is a separate Continuity feature that streams your iPhone's screen to the Mac on demand; it is not a sync mechanism. It also has its own quirks unrelated to iMessage. If Mirroring itself is broken on Tahoe, see the \",(0,n.jsx)(e.a,{href:\"/blog/iphone-mirroring-not-working-macos-tahoe-26-4-fix-2026\",children:\"iPhone Mirroring not working guide\"}),\". For actual iMessage sync, you still need Send & Receive and Messages in iCloud configured correctly as described above.\"]}),`\n`,(0,n.jsx)(e.p,{children:(0,n.jsx)(e.strong,{children:\"Q: My Mac shuts down sometimes and that seems to break iMessage \\u2014 coincidence?\"})}),`\n`,(0,n.jsxs)(e.p,{children:[\"Possibly not. Unclean shutdowns are a primary cause of \",(0,n.jsx)(e.code,{children:\"chat.db\"}),\" corruption. If your Mac shuts down unexpectedly with any regularity \\u2014 especially on Apple Silicon machines that have hit content-filter / network-extension issues \\u2014 fix the shutdown problem first. See the \",(0,n.jsx)(e.a,{href:\"/blog/macos-tahoe-26-5-1-m5-mac-shutdown-network-extension-content-filter-fix-2026\",children:\"macOS 26.5.1 M5 shutdown and content filter fix guide\"}),\" for that path.\"]}),`\n`,(0,n.jsx)(e.h2,{id:\"conclusion\",children:\"Conclusion\"}),`\n`,(0,n.jsxs)(e.p,{children:[\"iMessage not syncing between Mac and iPhone on macOS Tahoe is almost always one of four problems: a Send & Receive address mismatch, a stalled Messages in iCloud pipeline, local \",(0,n.jsx)(e.code,{children:\"chat.db\"}),' corruption on the Mac, or Apple Account drift left over from the mid-Tahoe identity migration. The \"sign out and back in\" sledgehammer fixes some of these and breaks others, which is why the diagnostic decision tree at the top of this guide matters. Spend the ninety seconds to triage, then apply the specific fix.']}),`\n`,(0,n.jsxs)(e.p,{children:[`If your devices share an Apple Account, both have Messages in iCloud on, both have matching Send & Receive settings including the same \"Start new conversations from\" identity, and the Mac's local `,(0,n.jsx)(e.code,{children:\"chat.db\"}),\" is clean, sync will work reliably and quickly. When it stops, you almost always changed one of those variables \\u2014 usually without realizing it.\"]}),`\n`,(0,n.jsxs)(e.p,{children:[(0,n.jsx)(e.strong,{children:\"Related reading\"}),\":\"]}),`\n`,(0,n.jsxs)(e.ul,{children:[`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:\"/blog/rcs-message-send-failure-macos-26-5-mac-ipad-watch-fix-2026\",children:\"RCS Message Send Failure on macOS 26.5 \\u2014 Mac, iPad, Watch Fix\"}),\" \\u2014 distinct issue, cellular gate vs iCloud sync.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:\"/blog/macos-tahoe-continuity-features-complete-troubleshooting-guide-2025\",children:\"macOS Tahoe Continuity Features: Complete Troubleshooting Guide\"}),\" \\u2014 for parallel issues with Handoff, Universal Clipboard, AirDrop.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:\"/blog/iphone-mirroring-not-working-macos-tahoe-26-4-fix-2026\",children:\"iPhone Mirroring Not Working on macOS Tahoe Fix\"}),\" \\u2014 for the Continuity feature most often confused with iMessage sync.\"]}),`\n`,(0,n.jsxs)(e.li,{children:[(0,n.jsx)(e.a,{href:\"/blog/mac-mail-not-working-complete-troubleshooting-fix-guide-2025\",children:\"Mac Mail Not Working: Complete Troubleshooting Fix Guide\"}),\" \\u2014 when more than one iCloud service is misbehaving at once.\"]}),`\n`]})]})}function d(i={}){let{wrapper:e}=i.components||{};return e?(0,n.jsx)(e,{...i,children:(0,n.jsx)(c,{...i})}):c(i)}return v(M);})();\n;return Component;","toc":[{"title":"Key Takeaways","url":"#key-takeaways","depth":2},{"title":"How iMessage Sync Actually Works on macOS Tahoe","url":"#how-imessage-sync-actually-works-on-macos-tahoe","depth":2},{"title":"The Apple Account Drift Problem","url":"#the-apple-account-drift-problem","depth":3},{"title":"Fast Diagnostic Decision Tree","url":"#fast-diagnostic-decision-tree","depth":2},{"title":"Mode A: Send & Receive Address Mismatch","url":"#mode-a-send--receive-address-mismatch","depth":2},{"title":"Check Send & Receive on Your Mac","url":"#check-send--receive-on-your-mac","depth":3},{"title":"Check Send & Receive on Your iPhone","url":"#check-send--receive-on-your-iphone","depth":3},{"title":"Why \"Start new conversations from\" Matters So Much","url":"#why-start-new-conversations-from-matters-so-much","depth":3},{"title":"The \"Phone Number Not Reachable\" Issue","url":"#the-phone-number-not-reachable-issue","depth":3},{"title":"iCloud Keychain Is a Hard Dependency","url":"#icloud-keychain-is-a-hard-dependency","depth":3},{"title":"Mode B: Messages in iCloud Stalled or Disabled","url":"#mode-b-messages-in-icloud-stalled-or-disabled","depth":2},{"title":"Confirm Messages in iCloud Is On (Both Devices)","url":"#confirm-messages-in-icloud-is-on-both-devices","depth":3},{"title":"What Messages in iCloud Actually Syncs","url":"#what-messages-in-icloud-actually-syncs","depth":3},{"title":"The Backfill Timeline","url":"#the-backfill-timeline","depth":3},{"title":"The Storage Hit","url":"#the-storage-hit","depth":3},{"title":"Mode C: chat.db Corruption on the Mac","url":"#mode-c-chatdb-corruption-on-the-mac","depth":2},{"title":"The Controlled Reset Procedure","url":"#the-controlled-reset-procedure","depth":3},{"title":"When the Controlled Reset Is Not Enough","url":"#when-the-controlled-reset-is-not-enough","depth":3},{"title":"Mode D: Apple Account Drift","url":"#mode-d-apple-account-drift","depth":2},{"title":"The SMS-from-Android Gotcha","url":"#the-sms-from-android-gotcha","depth":2},{"title":"What to Do If Old Messages Exist on iPhone but Not Mac","url":"#what-to-do-if-old-messages-exist-on-iphone-but-not-mac","depth":2},{"title":"Troubleshooting Common Issues","url":"#troubleshooting-common-issues","depth":2},{"title":"Problem: \"Waiting for Activation\" Won't Clear on the Mac","url":"#problem-waiting-for-activation-wont-clear-on-the-mac","depth":3},{"title":"Problem: New Messages Sync but Deletions Don't","url":"#problem-new-messages-sync-but-deletions-dont","depth":3},{"title":"Problem: Attachments Are Missing or Show as Broken Thumbnails","url":"#problem-attachments-are-missing-or-show-as-broken-thumbnails","depth":3},{"title":"Problem: Messages App Hangs for 30 Seconds on Launch","url":"#problem-messages-app-hangs-for-30-seconds-on-launch","depth":3},{"title":"Problem: Mac Shows Messages from One Conversation in Two Threads","url":"#problem-mac-shows-messages-from-one-conversation-in-two-threads","depth":3},{"title":"Problem: Group Chats Sync but One-on-Ones Don't (or Vice Versa)","url":"#problem-group-chats-sync-but-one-on-ones-dont-or-vice-versa","depth":3},{"title":"Problem: Mac Mail Also Stopped Working at the Same Time","url":"#problem-mac-mail-also-stopped-working-at-the-same-time","depth":3},{"title":"Problem: iCloud Drive Is Also Behaving Oddly","url":"#problem-icloud-drive-is-also-behaving-oddly","depth":3},{"title":"FAQ","url":"#faq","depth":2},{"title":"Conclusion","url":"#conclusion","depth":2}],"estimatedTime":27}