iCloud and cloud storage

Where cloud drives really mount

Updated 2026-07-31 · 4 min read

Apple moved every cloud provider into the Library folder, and a lot of things quietly broke.

What changed

Modern macOS requires sync providers to use the File Provider framework. Their folders now live at:

~/Library/CloudStorage/Dropbox
~/Library/CloudStorage/GoogleDrive-you@example.com
~/Library/CloudStorage/OneDrive-Personal

The Finder sidebar shows them as if nothing happened; the old ~/Dropbox-style folders are gone or are symlinks.

What broke

Spotlight coverage got worse. ~/Library is excluded territory, and while File Provider items get some special-case indexing, coverage of online-only files and depth of these trees is inconsistent — the practical experience is that cloud files are harder to find than when they lived in home folders.

Scripts and apps with hardcoded paths. Anything expecting ~/Dropbox needs the new path. Note the Google Drive folder name embeds your account email.

Terminal muscle memory. The paths are long and hostile; aliases help:

alias dropbox='cd ~/Library/CloudStorage/Dropbox*'

Working with it

Symlinks make the old ergonomics back:

ln -s ~/Library/CloudStorage/Dropbox ~/Dropbox

Finder, dialogs and the Terminal all follow it happily.

For search

find and mdfind -onlyin both work on these paths explicitly. An index that covers ~/Library treats CloudStorage like anywhere else — names of online-only files included, since placeholders have real directory entries. That combination (everything by name, regardless of download state) is exactly what the move took away from Spotlight users.

Common questions

Where did my Dropbox folder go?

Into ~/Library/CloudStorage/Dropbox, mandated by macOS's File Provider framework. A symlink restores the old path.

Why does Google Drive's folder have my email in its name?

File Provider names each provider folder per account — GoogleDrive-address — allowing multiple accounts side by side.