Fix OneDrive Files On-Demand issues on macOS 12.1 or later
Applies ToOneDrive (home or personal) OneDrive for Mac

On macOS 12.1 "Monterey" and later, macOS and OneDrive run a new Files On-Demand experience.

The macOS sync icons now look the same no matter which cloud service you use, and the macOS behavior might be new to you, so here are some useful tips:

Unable to turn off files on demand

From macOS 12.1, Files On Demand is part of macOS and cannot be turned off. You can still mark your files as Always Keep on This Device if you need them available when offline.

Always Keep on This Device not working

When you mark a file as "Always Keep on This Device" the cloud icon may remain. Below are the different conditions of an offline or online file or folder.

A locally available file or folder This file or folder is always available. It was an online-only file which has been downloaded (rather than marked as "Always Keep on This Device").

OneDrive for Mac file on demand status icon

Online-only file or folder This file or folder is only accessible when you are online and signed in to OneDrive.

OneDrive for Mac file on demand status icon

Unopened offline cloud file or folder This file or folder is always available. Both cloud and "Always available" icons are visible.

OneDrive for Mac file on demand status icon

Opened offline cloud file or folder  This file or folder is always available and has been opened. Once opened, the cloud icon disappears.

OneDrive for Mac file on demand status icon

Always Keep on This Device file size showing as zero bytes

If you see a difference between Size and Size on Disk when viewing file, folder or drive properties, read OneDrive disk space and file size don't match.

AutoSave not working

If you cannot find your files, read Missing files and autosave issues with OneDrive on macOS.

OneDrive couldn't start and other error messages

If you’re upgrading to macOS 12.1 from an earlier version, OneDrive needs to migrate the Files On-Demand experience and will automatically do so for you. 

If this process fails, you may get an error message. Below are examples of what that message might say, and how you can fix the problem. 

Close and re-open OneDrive, then restart your computer.

This error means the migration failed because of a failure in a system component. Restart your Mac and try launching OneDrive again. If you still get the error, make sure you have updated to the latest macOS version. 

This error is shown if you are running OneDrive on a file system other than Apple File System (APFS). Only APFS is supported in macOS 12.1 or later. You cannot run OneDrive on an HFS+. 

Convert the file system that has OneDrive to APFS. You can use Disk Utility to perform this conversion. After you convert the file system, restart OneDrive. 

This error is shown if your OneDrive folder is locked, or you don’t have write permissions. Make sure the folder is unlocked and it is fully writable by you. Then restart OneDrive. 

This error means the migration failed because of a system component. Restart your Mac and try launching OneDrive again. If you still get the error, make sure you have updated the latest macOS version. 

This error is shown if you were previously using Files On-Demand and have upgraded to macOS 12.1, and the migration failed for a reason other than as described earlier in this document.  

To correct this issue, you must reset your OneDrive.

Warning: Resetting your OneDrive will remove all local content. Anything that isn’t synced to the cloud may be lost.

To reset OneDrive: 

  1. Open Finder and navigate to the Applications folder.

  2. Right-click on the OneDrive app and select Show Package Contents.

  3. Go to Contents > Resources.

  4. Double-click to run ResetOneDriveAppStandalone.command.

    1. Depending on your OneDrive version, the command might be ResetOneDriveApp.command.

  5. Launch OneDrive and set it up again.

See also

Missing files and autosave issues with OneDrive on macOS

OneDrive disk space and file size don't match

Blog post: Inside the new Files On-Demand Experience on macOS

Need more help?

Contact support icon

Contact Support For help with your Microsoft account and subscriptions, visit Account & Billing Help.

For technical support, go to Contact Microsoft Support, enter your problem, and select Get Help. If you still need help, shake your mobile device and select Report a problem.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.