OneDrive File Issues

How to Recover OneDrive Files Replaced by .icloud Placeholders on Mac

Phi Hung VoPhi Hung Vo Nov 2, 2026 870 views

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.

How to Recover OneDrive Files Replaced by .icloud Placeholders 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 you start

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.

Solution 1Recommended

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.

1
Stop iCloud Synchronization Temporarily

Open your Mac's System Settings, click on your Apple ID, navigate to iCloud, and temporarily pause iCloud Drive synchronization.

2
Unlink Your Mac in OneDrive

Click the OneDrive cloud icon in your Mac menu bar, go to Help & Settings > Preferences > Account, and click 'Unlink this Mac'.

3
Move the OneDrive Folder

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.

4
Relink and Re-sync OneDrive

Open the OneDrive app, sign back in, and when prompted for the folder location, select the new location in your root user directory.

Resolve Sync Conflict by Relocating the OneDrive Folder
Free Microsoft Office alternative

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.

Built-in WPS Cloud storage avoids third-party macOS sync conflicts.Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx).Lightweight architecture uses minimal system resources on Mac.Easy-to-use Auto-Backup and File Roaming features prevent document data loss.
microsoft office alternative - wps office

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.