SharePoint Document Issues

Fix a SharePoint File with a Red OneDrive Sync X

Ayan MasoodAyan Masood Nov 14, 2026 868 views

Question details

Resolve a red OneDrive sync X on a file in a synchronized SharePoint library.

Fix a SharePoint File with a Red OneDrive Sync X
Product
Microsoft SharePoint and OneDrive sync client
Device & OS
Windows
Scenario
A user is synchronizing a SharePoint document library with File Explorer.
Observed behavior
One file shows a red X and remains unsynchronized after OneDrive is stopped and restarted.
Before you start

Find the affected file in File Explorer and check the OneDrive notification area for a detailed sync error. If the file contains unsynced changes, ensure it is available locally before moving it.

Solution 1Recommended

Remove the affected file and resync the SharePoint library

Use this method to isolate the file and reconnect the library when restarting OneDrive has not helped.

1
Check the sync error

Select the OneDrive cloud icon in the Windows notification area and open any sync error details. Note the affected file and any specific instructions.

2
Move the file out

In File Explorer, move the affected file to a local folder outside the synchronized library, such as a folder on the Desktop. Check whether the remaining library files synchronize.

3
Stop syncing the library

Select the OneDrive cloud icon, open Settings > Account, find the affected SharePoint library, and select Stop sync.

4
Reconnect the library

Open the document library in SharePoint in your browser and select Sync. Follow the prompts to reconnect it to OneDrive, then wait for synchronization to finish.

5
Return the file

In File Explorer, move the file back into the synchronized library and check the OneDrive icon for errors. If a file with the same name already exists, compare the copies before replacing either one.

Remove the affected file and resync the SharePoint library
Free Microsoft Office alternative

Work with Office documents in WPS Office

WPS Office is a free, lightweight Office alternative with a familiar interface and support for common Microsoft Office formats, making it easy to continue working with existing documents. It does not repair OneDrive or SharePoint sync errors.

Open and edit documents from your local SharePoint sync folderCompatible with Microsoft Word, Excel, and PowerPoint formatsFamiliar interface for an easier transition from Microsoft OfficeFree and lightweight productivity tools
microsoft office alternative - wps office

Frequently Asked Questions

Where can I find the reason for the red X?

Select the OneDrive cloud icon in the Windows notification area and open the sync error details. The message may identify the file and explain what needs attention.

Will stopping sync delete the SharePoint library online?

Stopping sync disconnects the library from the OneDrive sync client; it does not delete the online SharePoint library. Keep any unsynced local changes in a separate local folder before reconnecting.

What should I do if the file already exists after I reconnect the library?

Compare the local copy with the file in the reconnected library before replacing either one. Keep both under different names if you need to review their changes.

Does resetting OneDrive delete my online files?

Resetting the OneDrive sync client does not delete files stored online, but it can restart synchronization. After running the reset command, reopen OneDrive if needed and check the sync status.