Why Mac Documents storage is huge, and how to find it
In System Settings, General, Storage, “Documents” can show tens of gigabytes while your Documents folder in Finder holds only a few. Here is why that happens and how to find the real space users, step by step.
Why the numbers do not match
Storage settings sorts space by kind of file, not by folder. Files that macOS does not file under apps, photos, music or system can end up in “Documents”, wherever they live on disk.
A lot of that space sits in places Finder hides by default: folders whose names start with a dot, such as .config, and your Library folder. Apps keep chats, backups, caches and tool data there, and Storage counts it without telling you where it is.
1. Show hidden files in Finder
Open any folder in Finder and press ⌘ ⇧ . (Command, Shift, Period). Hidden items appear faded. Press it again to hide them. This shows the dot folders in your home folder, but not sizes.
2. Open your Library folder
In Finder, open the Go menu, hold the Option key and choose Library. This is where apps keep their data.
3. Measure what is big, with Terminal
Finder does not show folder sizes in a list by default. This command prints the 15 biggest items in your home folder, hidden ones included:
du -sk ~/.[!.]* ~/* 2>/dev/null | sort -rn | head -15 | awk '{printf "%.1f GB %s\n", $1/1048576, $2}'
Run it again inside any big folder by replacing ~ with that folder's path. It only reads, so it is safe to run.
4. Where hidden space usually sits
~/.configand other folders that start with a dot: tool and app data, sometimes backups made by phone-transfer tools.~/Library/Group Containersand~/Library/Containers: data of chat apps and other sandboxed apps. Chat apps keep messages and media here.~/Library/Application Support: editors, browsers and many other apps.~/Library/Application Support/MobileSync/Backup: iPhone and iPad backups.node_modules,.venvandPodsinside project folders: packages that can be rebuilt, often dozens of copies.~/Library/Androidand~/.android: Android SDKs and emulator disks.~/Library/Developer: Xcode simulators and build data.- Docker's disk image,
Docker.raw, inside~/Library/Containers/com.docker.docker.
5. What is safe to delete
- Usually safe: caches, logs, rebuildable folders such as
node_modules, and leftover data of apps you already removed. - Check first: SDKs, simulators, old downloads, and hidden folders you do not recognise.
- Keep a copy before deleting: chat backups, phone backups, documents, photo libraries, and projects with work that is not saved elsewhere.
Move things to the Trash first, use your Mac for a day, and empty the Trash only when nothing broke.
A faster way: Tidy
Tidy does these steps for you. It is a free, open-source Mac disk cleaner that lists hidden app data and folders Finder does not show, rates every item Safe, Review or Critical, and lets you open any folder to look inside. Nothing is deleted until you confirm, and your own files go to the Trash.