{"id":"icloud.icloud-optimisation-failed-message","url":"/faq/icloud/icloud-optimisation-failed-message","category":{"id":"icloud","title":"iCloud & iCloud Photos"},"subcategory":{"id":"icloud-troubleshooting","title":"Troubleshooting iCloud space"},"question":"What should I do when Storage Studio says iCloud optimisation failed?","alt_questions":["iCloud optimisation failed storage studio","Couldn't finish making cloud files online-only","Optimize iCloud error","Cloud optimisation failed what now","Optimise iCloud locally failed"],"short_answer":"The pass stopped early, but nothing was deleted. Check iCloud Drive is on, give Storage Studio Full Disk Access, close open iCloud documents and retry — or use Run Tuhi or Finder's Remove Download instead.","answer_markdown":"It means the pass stopped before it could finish making files online-only. Nothing was deleted — any file it hadn't reached is still downloaded, and any file it had freed is still safe in iCloud.\n\nTry these in order:\n\n1. Check iCloud Drive is turned on and signed in, in **System Settings → your name → iCloud**.\n2. Make sure Storage Studio has **Full Disk Access** (System Settings → Privacy & Security → Full Disk Access).\n3. Close apps that have big iCloud documents open, then try again.\n4. Use **Run Tuhi** or Finder's **Remove Download** instead, which work on every supported macOS.\n\nThe Background Activity view also records the run, so you can see when it last worked. See [troubleshooting](/manual/troubleshooting).","answer_html":"

It means the pass stopped before it could finish making files online-only. Nothing was deleted — any file it hadn't reached is still downloaded, and any file it had freed is still safe in iCloud.

\n

Try these in order:

\n
  1. Check iCloud Drive is turned on and signed in, in System Settings → your name → iCloud.
  2. Make sure Storage Studio has Full Disk Access (System Settings → Privacy & Security → Full Disk Access).
  3. Close apps that have big iCloud documents open, then try again.
  4. Use Run Tuhi or Finder's Remove Download instead, which work on every supported macOS.
\n

The Background Activity view also records the run, so you can see when it last worked. See troubleshooting.

","answer_text":"It means the pass stopped before it could finish making files online-only. Nothing was deleted — any file it hadn't reached is still downloaded, and any file it had freed is still safe in iCloud.\n\nTry these in order:\n\n1. Check iCloud Drive is turned on and signed in, in System Settings → your name → iCloud.\n2. Make sure Storage Studio has Full Disk Access (System Settings → Privacy & Security → Full Disk Access).\n3. Close apps that have big iCloud documents open, then try again.\n4. Use Run Tuhi or Finder's Remove Download instead, which work on every supported macOS.\n\nThe Background Activity view also records the run, so you can see when it last worked. See troubleshooting.","tags":["troubleshooting","icloud drive","error"],"related":[{"id":"icloud.why-cant-storage-studio-free-a-whole-icloud-folder-on-newer-macos","question":"Why does Optimize Cloud Storage send me to Finder's Remove Download on newer macOS?","url":"/faq/icloud/why-cant-storage-studio-free-a-whole-icloud-folder-on-newer-macos"},{"id":"icloud.why-doesnt-storage-studio-find-my-icloud-drive","question":"Why doesn't iCloud Drive appear in Storage Studio's Optimize Cloud Storage menu?","url":"/faq/icloud/why-doesnt-storage-studio-find-my-icloud-drive"}],"applies_to":"all","last_reviewed":"2026-10-01","title":"What should I do when Storage Studio says iCloud optimisation failed? — Storage Studio FAQ","description":"The pass stopped early, but nothing was deleted. Check iCloud Drive is on, give Storage Studio Full Disk Access, close open iCloud documents and retry — or use Run Tuhi or Finder's Remove Download instead.","crumbs":[{"name":"Home","path":"/"},{"name":"FAQ","path":"/faq/"},{"name":"iCloud & iCloud Photos","path":"/faq/icloud/"},{"name":"What should I do when Storage Studio says iCloud optimisation failed?","path":"/faq/icloud/icloud-optimisation-failed-message"}],"jsonld":{"@context":"https://schema.org","@type":"FAQPage","url":"https://storagestudio.us/faq/icloud/icloud-optimisation-failed-message","inLanguage":"en","dateModified":"2026-10-01","mainEntity":[{"@type":"Question","name":"What should I do when Storage Studio says iCloud optimisation failed?","alternateName":["iCloud optimisation failed storage studio","Couldn't finish making cloud files online-only","Optimize iCloud error","Cloud optimisation failed what now","Optimise iCloud locally failed"],"acceptedAnswer":{"@type":"Answer","text":"It means the pass stopped before it could finish making files online-only. Nothing was deleted — any file it hadn't reached is still downloaded, and any file it had freed is still safe in iCloud.\n\nTry these in order:\n\n1. Check iCloud Drive is turned on and signed in, in System Settings → your name → iCloud.\n2. Make sure Storage Studio has Full Disk Access (System Settings → Privacy & Security → Full Disk Access).\n3. Close apps that have big iCloud documents open, then try again.\n4. Use Run Tuhi or Finder's Remove Download instead, which work on every supported macOS.\n\nThe Background Activity view also records the run, so you can see when it last worked. See troubleshooting.","url":"https://storagestudio.us/faq/icloud/icloud-optimisation-failed-message"}}]},"fragment":"
\n
\n\n\n\n\n
\n
\n

iCloud & iCloud Photos · Troubleshooting iCloud space

\n

What should I do when Storage Studio says iCloud optimisation failed?

\n

Short answer: The pass stopped early, but nothing was deleted. Check iCloud Drive is on, give Storage Studio Full Disk Access, close open iCloud documents and retry — or use Run Tuhi or Finder's Remove Download instead.

\n

It means the pass stopped before it could finish making files online-only. Nothing was deleted — any file it hadn't reached is still downloaded, and any file it had freed is still safe in iCloud.

\n

Try these in order:

\n
  1. Check iCloud Drive is turned on and signed in, in System Settings → your name → iCloud.
  2. Make sure Storage Studio has Full Disk Access (System Settings → Privacy & Security → Full Disk Access).
  3. Close apps that have big iCloud documents open, then try again.
  4. Use Run Tuhi or Finder's Remove Download instead, which work on every supported macOS.
\n

The Background Activity view also records the run, so you can see when it last worked. See troubleshooting.

\n\n

Last reviewed

\n\n

Related questions

\n

Also available as Markdown and JSON.

\n
"}