MainspringGuides › iCloud Full
macOS Guide

Save documents to your Mac when iCloud is full

Updated August 2026 · 3 min read

When iCloud storage is full, new files you save into iCloud Drive don't error out — they quietly queue up with a "waiting to upload" badge and sit there. If you're not going to buy more storage, the cleaner fix is to stop pointing new documents at iCloud at all. One preference makes fresh files save straight to your Mac, where a full cloud plan can't slow them down.

Send new documents to local storage

macOS defaults every new document's Save sheet to iCloud Drive. Flip that to your Mac with one command in Terminal (Applications → Utilities):

# Save new documents to your Mac, bypassing the full iCloud plan
defaults write NSGlobalDomain NSDocumentSaveNewDocumentsToCloud -bool false

# Undo — once you've freed up or bought iCloud space
defaults write NSGlobalDomain NSDocumentSaveNewDocumentsToCloud -bool true

Now TextEdit, Preview, Pages, Numbers, and other built-in document apps open their Save sheet on a local folder. The file writes instantly and never joins the upload queue. Quit and reopen any app you already have running so it reads the change. This behaves identically on macOS 13 Ventura, 14 Sonoma, and 15 Sequoia.

Why files "won't save" when iCloud is over quota

A full iCloud account creates a confusing state: the document appears to save, but Finder shows a dashed-circle or cloud badge and iCloud Settings reads "waiting to upload." The bytes are on your Mac, but iCloud keeps trying — and failing — to sync them, and every new file joins the same stuck line. Point new documents locally and there's no upload to fail. You get an ordinary file with no sync status attached to it, which is exactly what you want while you're over quota.

This is a targeted move, not a teardown. You're not signing out of iCloud or disabling iCloud Drive — Photos, Messages, and anything already syncing carry on. You've only changed the default location for brand-new documents.

While you're at it: free some space or right-size the plan

Saving locally solves the immediate save problem. If you'd like the upload queue to clear too, decide between clearing room and paying for more:

None of that is required to save your work today, though — the command above already handles that part.

Flip it back when you have room

Mainspring makes "Save new documents to the Mac" a labelled toggle — turn it on while iCloud is full, turn it back off the day you free up space. One click each way, no command to memorize, alongside 90+ other hidden macOS settings.

Try Mainspring free →

Signed & notarized by Apple · 1-day free trial · $29 once

Clear the backlog that filled iCloud

Old iPhone and iPad backups are the single biggest hidden consumer of most people's iCloud plans. See how to delete old device backups from iCloud on Mac to reclaim space in minutes.