Desktop Files Missing After macOS Tahoe Update? 9 Fixes

First, the part that matters most: in most cases your files are not deleted. They are just sitting somewhere other than where you expect.

I want to be honest with you though, because I read through the actual Apple forum threads on this before writing, and they are messier than the usual "10 easy fixes" posts admit. For most people the files turn up in iCloud or in a folder the update quietly created. For a few people, mostly anyone without a backup, some files really were lost. So we are going to do this carefully. Check the safe stuff first, and do not touch anything that could make it worse.

The first time my own Desktop went empty after a macOS update, I was sure I had lost a folder of work. I had not. It was sitting in iCloud with a little cloud icon, half downloaded. But I have also watched someone panic, start flipping iCloud settings, and shove their files somewhere even harder to find. So slow is fast here.

Here is the order I would actually go in.

First: Do Not Touch the iCloud Settings Yet

Before anything, a warning that comes straight from people who lost files. Do not start switching "Desktop and Documents in iCloud" on and off, do not reinstall macOS, and do not erase anything. Toggling that one iCloud setting is exactly what relocates files and makes them harder to find. We will get to iCloud, just carefully.

Work down the list and you will most likely find them long before the scary stuff.

Step 1: Check Another Device First

This is the calmest place to start. If your files were in iCloud, there is a good chance they are sitting safe in the cloud right now, and you can confirm that before you change a single thing on your Mac.

Here's what to do:

• On your iPhone or iPad, open the Files app, tap iCloud Drive, and look in Desktop and Documents.
• Or on any computer, go to iCloud.com, sign in, and open iCloud Drive.
• If your files show up there, breathe out. They are safe. The rest of this is just about getting them back down onto your Mac.

Step 2: Look in iCloud Drive on Your Mac

This is where the files are hiding nine times out of ten. macOS Tahoe is pushy about moving your Desktop and Documents into iCloud Drive, so they are not on your "local" Desktop anymore. They live under iCloud now.

Here's what to do:

• Open Finder.
• In the left sidebar, under iCloud, click Desktop and Documents.
• See a small cloud icon with a down arrow next to a file or folder? That means it is in iCloud but not downloaded yet. Click it, or right click and choose Download Now, to pull it back.

Pro tip: Get on Wi-Fi and give it time. With a lot of files, iCloud looks completely frozen right up until everything suddenly appears at once.

Step 3: Look for a Folder Named After Your Mac

Here is one almost no guide mentions, and it is the thing that solved it for real people in the threads. When iCloud merges the Desktops from more than one Mac, it sometimes tucks your files into a nested folder named after your computer.

Here's what to do:

• In Finder, open iCloud Drive.
• Look for a folder called something like Desktop – [Your Mac's Name], or a Desktop folder nested inside another folder.
• Your missing files are very often sitting right inside it, untouched.

Step 4: Check the "iCloud Drive (Archive)" and "Relocated Items" Folders

When the update cannot place your files normally, it does not throw them away. It drops them into one of two rescue folders that most people never know exist.

Here's what to do:

• In Finder, press Command + Shift + G (Go to Folder).
• Paste this and press Return: ~/iCloud Drive (Archive)
• Then check the other one: /Users/Shared/Relocated Items (it often has a "Security" subfolder inside).
• Drag anything you find back onto your Desktop and you are done.

Step 5: Check Your Local Home Folder

Here is the part that confuses everybody: you can end up with two Desktop folders. The iCloud one, and a plain local one inside your Home folder. If iCloud sync got toggled at some point, your files may have landed in the local one.

Here's what to do:

• In Finder, click Go in the menu bar, then Home (or press Command + Shift + H).
• Open the Desktop and Documents folders here. These are the local ones, separate from iCloud.
• Your files may be sitting in here the whole time.

Step 6: Make Sure You Are in the Right User Account

Quick one, but it catches people. Sometimes a big update signs into a different account, or creates a new one, and you are just looking at an empty Desktop that is not actually yours.

Here's what to do:

• Open the Apple menu, then System Settings, then Users and Groups.
• If there is more than one account, or a name you do not recognise, log out (Apple menu, then Log Out) and sign back into your account.

If your Desktop fills back up the second you log into the right account, that was the whole thing.

Step 7: Re-establish iCloud Sync, Carefully

If you saw your files in the cloud back in Step 1 but they just will not come down to your Mac, sync is stuck. Re-establishing it usually kicks the download back to life, and real users reported their files reappearing after doing exactly this.

Here's what to do:

• First, check you actually have enough iCloud storage (Apple menu, System Settings, your name, iCloud). If iCloud is full, nothing syncs.
• Glance at Apple's System Status page to be sure iCloud is not down on Apple's end.
• Then sign out and back in: System Settings, your name, scroll to the bottom, Sign Out, then sign back in. Give it time to re-sync.

Important: Do not turn OFF "Desktop and Documents" in iCloud to "reset" it. That is the move that relocates files and makes the mess worse. Sign out and back in instead. It re-syncs without moving anything around.

Step 8: The Quick Classics

Worth a couple of minutes before the heavy options.

Here's what to do:

• Trash: open it from the Dock. If your files are in there, right click and choose Put Back. Get them out before you empty it.
• Hidden files: click your Desktop and press Command + Shift + Period (.) to reveal anything that was hidden.
• iCloud Recently Deleted: at iCloud.com, open iCloud Drive, then Recently Deleted (it holds files for 30 days). Also check Account Settings, then Restore Files.
• Restart, then wait ten minutes. Your Mac is rebuilding the Spotlight index after the update, so search can come up empty for a while even when the files are sitting right there.

Step 9: Restore From Time Machine

I put this last, but I will be honest, read the threads and it is the most reliable fix of the whole list. The people who got everything back almost all did it with Time Machine, restoring from a backup made before the update.

Here's what to do:

• Plug in your Time Machine drive.
• Open the folder your files used to live in.
• Open Time Machine from the menu bar or System Settings.
• Use the timeline to step back to a point before the Tahoe update.
• Select your files or folders and click Restore.

If you cannot even get into your account normally, restart holding Command + R to reach macOS Recovery, then choose Restore from Time Machine Backup.

If They Are Genuinely Gone

I will be straight with you, because the forums are. Sometimes files were never synced to iCloud and there is no backup, and in that case they may really be gone. Here is your last line of defense:

• Data recovery software. Disk Drill and similar tools can scan your drive for deleted files that have not been overwritten yet. Use the Mac as little as possible until you run one, because every new file written lowers your odds.
• Apple Support, and ask for a senior advisor. This one matters. In the threads, a junior advisor told people they were out of luck, but a senior advisor escalated the same case as a genuine issue. If the first person cannot help, politely ask to escalate.
• iCloud recovery within 30 days at iCloud.com, under Account Settings, then Restore Files.

Quick Recap

In the order I would actually check:

1. Confirm the files are safe in iCloud from another device or iCloud.com
2. iCloud Drive on your Mac, click the cloud icon to download them
3. A nested folder named after your Mac inside iCloud Drive
4. The iCloud Drive (Archive) and Relocated Items folders
5. Your local Home Desktop and Documents
6. Are you in the right user account
7. Re-establish iCloud sync by signing out and in, never toggle Desktop and Documents off
8. Trash, hidden files, Recently Deleted, restart
9. Time Machine restore from before the update

And the real lesson buried in every one of those forum threads: iCloud is a sync service, not a backup. If you do not already run Time Machine, set it up the moment your files are back. It is ten minutes today that saves you one very bad day later.

Where to Next

More macOS Tahoe help: This fix is part of our macOS Tahoe problems and fixes guide, a single place that rounds up every common Tahoe issue. If something else on your Mac is acting up after the update, start there.