How to Recover OneDrive Files Replaced by .icloud Placeholders on Mac
Question details
Users need to recover valid OneDrive or SharePoint documents that have been replaced by empty .icloud placeholders due to conflicting cloud synchronization services on Mac.

- Product
- OneDrive
- Device & OS
- Mac
- Scenario
- A user is running both Microsoft OneDrive and Apple iCloud sync simultaneously, and the OneDrive folder is located within an iCloud-backed directory like Desktop or Documents.
- Observed behavior
- Valid synchronized files in OneDrive are overwritten or replaced by empty .icloud placeholder files, often with no previous versions available locally.
Before making changes to your local sync settings, log into your OneDrive or SharePoint account via a web browser to verify if your original files are still intact in the cloud.
Resolve Sync Conflict by Relocating the OneDrive Folder
Prevent iCloud from interfering with OneDrive by moving your OneDrive sync folder to a location that iCloud does not back up.
Conflicts occur when iCloud attempts to offload files to save space while OneDrive is also trying to sync them. Separating their directories prevents these .icloud placeholders from being generated.
Open your Mac's System Settings, click on your Apple ID, navigate to iCloud, and temporarily pause iCloud Drive synchronization.
Click the OneDrive cloud icon in your Mac menu bar, go to Help & Settings > Preferences > Account, and click 'Unlink this Mac'.
Locate your current OneDrive folder (often found in Desktop or Documents). Move this folder to your root user directory (e.g., /Users/YourUsername/) which is not synced by iCloud.
Open the OneDrive app, sign back in, and when prompted for the folder location, select the new location in your root user directory.

Restore Original Files via OneDrive Version History
If files were replaced and the local data is lost, use OneDrive's online version history to restore the files to a state before the .icloud placeholder was created.
Reset the OneDrive Application
Clear lingering sync caches by fully resetting the OneDrive app if .icloud files continue to appear occasionally after fixing the folder conflict.
Use WPS Office for Reliable Cloud Document Management
Avoid complicated sync conflicts between Microsoft OneDrive and Apple iCloud on your Mac. WPS Office is a lightweight, fully compatible office suite that offers its own seamless cloud storage, ensuring your documents are safe, accessible, and free from third-party sync overwrites.

Frequently Asked Questions
What exactly is an .icloud file on my Mac?
An .icloud file is a placeholder created by Apple's iCloud Drive. It indicates that the actual file has been offloaded to cloud storage to save local disk space, or it is currently in the process of synchronizing.
Why did my OneDrive files turn into .icloud files?
This happens when your OneDrive sync folder is placed inside a directory that iCloud is also set to sync (like the Desktop or Documents folder). iCloud's space-saving feature offloads the files, replacing them with .icloud placeholders, which disrupts OneDrive's native syncing.
How do I stop iCloud from syncing my Mac's Desktop and Documents?
Go to System Settings > Apple ID > iCloud > iCloud Drive, and disable the 'Desktop & Documents Folders' option. Be aware that doing this keeps your current files in iCloud but removes them locally, so you should back them up to another local folder first.
Can I open an .icloud file directly?
No, you cannot open an .icloud file directly because it contains no actual data. You must click the cloud download icon next to the file in Finder to download the original file back to your local storage before opening it.




