logo
search
OneDrive File Issues

How to Fix OneDrive Desktop.ini and Other Sync Errors

Maira MehtabMaira Mehtab Sep 22, 2026 869 views

Question details

The user is unable to sync files to OneDrive because a 'Desktop.ini' file is blocking the synchronization queue, causing several other files to fail as well.

Product
OneDrive
Device & OS
Windows
Scenario
Backing up local folders or attempting to synchronize files to OneDrive cloud storage.
Observed behavior
OneDrive displays an error stating that Desktop.ini is not allowed and cannot be synchronized, which simultaneously halts the sync process for other queued items.
Before you start

Ensure you are logged into your OneDrive account on your Windows device and verify exactly which folders (e.g., Documents, whole C: drive) you are attempting to sync.

Solution 1Recommended

Remove or Move the Desktop.ini File from OneDrive

Because desktop.ini is a hidden Windows configuration file that OneDrive does not support, removing it from the sync directory resolves the blockage.

Windows uses desktop.ini files to store folder customization settings like custom icons. These files are not meant to be synced to the cloud and often trigger errors in OneDrive.

1
Enable hidden files visibility

Open File Explorer in Windows. Click on the 'View' tab at the top of the window and check the box for 'Hidden items' so you can see system files.

2
Locate the problematic file

Navigate to the specific OneDrive folder referenced in your sync error and look for a faded icon named 'desktop.ini'.

3
Remove the file

Right-click the desktop.ini file and select 'Delete' (or move it to a local folder outside of the OneDrive directory).

4
Resume synchronization

Click the OneDrive cloud icon in your taskbar and check if the remaining blocked files begin to sync successfully.

Safe to Delete: Deleting a desktop.ini file will not delete any of your personal documents; it will simply reset the folder's display settings to default.
Free Microsoft Office alternative

Avoid Complex Cloud Errors with WPS Office

Struggling with system file conflicts and sync blockages in OneDrive? Consider switching to WPS Office. It provides an integrated, hassle-free cloud experience (WPS Cloud) designed specifically for your documents, entirely bypassing Windows system file errors.

  1. 1. Download and install: Visit the official WPS Office website to download and install the free software on your PC.
  2. 2. Log in for cloud space: Sign in to your WPS account to instantly activate your dedicated WPS Cloud storage.
  3. 3. Save securely: Save your spreadsheets and documents directly to WPS Cloud without relying on external folder sync services.
Built-in WPS Cloud handles your document backups smoothly without desktop.ini interruptions.Fully compatible with Microsoft Office formats including .docx, .xlsx, and .pptx.Lightweight, fast, and does not require syncing entire Windows user folders.Free to use with a familiar, tabbed interface for enhanced productivity.
microsoft office alternative - wps office

Frequently Asked Questions

What is a desktop.ini file and why is it in my OneDrive?

A desktop.ini file is an automatically generated Windows system file that dictates how a folder is displayed, such as its custom icon. It appears in OneDrive if you choose to sync a folder that Windows has previously customized.

Will deleting desktop.ini ruin my computer or files?

No. Deleting a desktop.ini file is completely safe. The only consequence is that the specific folder will revert to its default Windows appearance and lose any custom folder icon you might have set.

Why does one desktop.ini file block other files from syncing?

OneDrive processes files in a queue. When it encounters an unsupported file like desktop.ini that it cannot process, it may temporarily pause or block the upload queue, causing the remaining valid files to display a 'sync pending' or error status.