Overview
A red X on a OneDrive file or folder means OneDrive could not synchronize that item successfully. The most useful first step is to open the OneDrive error and identify the exact file and reason.
Why this happens
Red-X errors commonly come from invalid names, long paths, file locks, permissions, storage limits, unsupported file types, duplicate names, or authentication problems.
Before You Begin
- Record the exact file or folder with the red X.
- Capture the OneDrive error message.
- Confirm whether the item exists on the web.
- Do not overwrite competing versions until they are compared.
Click-by-Click Troubleshooting
Step 1: Open the OneDrive sync error
Action: Select the OneDrive cloud icon and select the displayed sync problem or red-X item.
Why this matters: OneDrive usually provides a file-specific reason instead of requiring guesswork.
What to look for: Look for naming, path, permission, storage, conflict, or sign-in messages.
Expected result: You should have a specific error tied to an affected item.
Step 2: Compare the file on the web
Action: Open OneDrive on the web and locate the same file or folder.
Why this matters: This confirms whether the cloud copy exists and whether the problem is local-only.
What to look for: Compare name, size, modified time, and whether the item opens.
Expected result: You should identify whether the local or cloud copy is authoritative.
Step 3: Check file name and path
Action: Review the full local path and file name in File Explorer. Shorten only clearly excessive folder or file names if business naming requirements allow.
Why this matters: Unsupported characters and excessive path length can prevent synchronization.
What to look for: Look for very deep folders, duplicate names, or characters OneDrive identifies as invalid.
Expected result: A naming or path issue should clear after a safe supported name is used.
Step 4: Check whether the file is locked
Action: Save and close the affected document in Office or any other application, then allow OneDrive to retry.
Why this matters: Locked files can prevent OneDrive from completing an upload or rename.
What to look for: Watch whether the red X disappears after the application releases the file.
Expected result: A temporary file-lock problem should clear after the file is closed.
Step 5: Check storage and permissions
Action: Review OneDrive storage in Microsoft 365 and verify that the user can open the destination folder on the web.
Why this matters: Storage limits and permission changes can block otherwise valid files.
What to look for: Look for quota warnings or Access denied on the destination.
Expected result: The account should have both available storage and permission to the destination.
Step 6: Restart the OneDrive client
Action: Select the OneDrive cloud icon > Help & Settings > Quit OneDrive, reopen it from Start, and recheck the item.
Why this matters: This clears temporary client state without resetting the sync relationship.
What to look for: Confirm whether the same item still shows a red X.
Expected result: Persistent red-X errors should now have enough evidence for targeted escalation.
What to Look For
- One item fails: file-specific issue.
- Many items fail: account, storage, permission, or client issue.
- Cloud copy works: local sync issue.
- Access denied on web: permission issue.
When to Stop
When to Contact IT
Contact J3 Systems Group if red-X errors affect many files, permissions or storage are involved, the same file repeatedly fails, or cloud/local versions conflict. Include article code KB-02.003, the exact file path, and the OneDrive error.
Need help with this issue?
J3 Systems Group supports small businesses and nonprofits with Microsoft 365, Google Workspace, cybersecurity, devices, documentation, and day-to-day IT operations.
Contact J3 Systems GroupAuthoritative references
Vendor interfaces, licensing, and security guidance can change. Verify current platform behavior against the primary documentation below before making high-impact production changes.