OneDrive Files Not Appearing Online

When you add or edit files in your local OneDrive folder but they do not appear in the OneDrive web portal or on other devices, the outbound sync pipeline is stalled.

This guide outlines how to diagnose upload bottlenecks, check storage constraints, and execute resolution scripts on Windows and macOS.

---

Understand why files fail to upload to the cloud

A failure to upload files to OneDrive Online is typically triggered by:

1. Exceeded Storage Quota: Your OneDrive cloud account is full, prompting the server to reject all incoming file uploads.
2. File System Locks: An active application (such as a database engine or image editor) is holding a lock on the file, preventing the OneDrive daemon from reading it.
3. Invalid File Extensions: OneDrive restricts certain temporary or system files (like .tmp, .lock, .DS_Store, or desktop.ini) from uploading.
4. Client Database De-synchronization: The local sync engine database is corrupted, causing it to lose track of changes in the local directory.

---

Check cloud storage quotas and limits

If your account has run out of storage space, OneDrive will stop uploading.

1. View Cloud Storage Usage

1. Go to the OneDrive Web Portal.
2. Look at the lower-left corner to verify your storage usage.
3. If it displays “Storage full”, you must delete files or upgrade your subscription to resume uploading.

---

Troubleshoot file upload issues on Windows

On Windows, the OneDrive desktop client can get stuck indexing local changes if files are locked or the sync cache is corrupted.

1. Identify Stuck Files

Check if OneDrive is blocked by a specific file:

1. Click the OneDrive cloud icon in the taskbar.
2. Click the warning message or check the list of files.
3. If a file is labeled “In use” or “Locked”, close the application using it.

2. Reset the OneDrive Client Cache

If OneDrive is stuck indefinitely on “Processing changes” without uploading, reset it:

%localappdata%\Microsoft\OneDrive\onedrive.exe /reset

If that path is not found, use:

"C:\Program Files\Microsoft OneDrive\onedrive.exe" /reset

3. Release File Handles (Unlock Files)

If a file cannot sync because it is locked by a ghost process, force close the file handle via PowerShell (replace file.ext with your actual file):

Stop-Process -Name "excel" -Force -ErrorAction SilentlyContinue
Stop-Process -Name "winword" -Force -ErrorAction SilentlyContinue

---

Troubleshoot file upload issues on macOS

On macOS, files must be moved into the sandboxed ~/Library/CloudStorage folder. Permission blocks or background daemon failures will prevent uploads.

1. Force Relaunch the Sync Engine and FileProvider

Open Terminal and restart the file syncing service:

killall -9 fileproviderd
killall OneDrive
open -a OneDrive

2. Check for File Permission Issues

Ensure the OneDrive application has permission to read the files. Run this command to check permissions (and repair them if needed):

chmod -R 755 ~/Library/CloudStorage/OneDrive-Personal

(For Business accounts, replace OneDrive-Personal with OneDrive-Shared or your tenant name).

3. Clear Sandbox Cache Directories

If macOS continues to block uploads, reset the cache configuration:

/Applications/OneDrive.app/Contents/Resources/ResetOneDriveAppStandalone.command

---

Identify and resolve file system locks and exclusions

OneDrive does not sync temporary, backup, or hidden system files:

• Excluded Extensions: .tmp, .laccdb, ~$* (temporary Word/Excel files), .DS_Store.
• Hidden Files: Files with the “Hidden” attribute on Windows or a dot (.) prefix on macOS.
• Maximum File Size Limit: For personal OneDrive accounts, the maximum file upload size is 250 GB. Verify that the file you are uploading does not exceed this limit.

---

Summary Checklist

Action Item	Verification Method	Status
Verify Storage Space	Check storage quota on the web portal	[ ]
Close Open Applications	Exit Word, Excel, CAD, or databases lock files	[ ]
Reset Local Client	Run /reset command to re-index the directory tree	[ ]
Verify File Name/Type	Ensure files do not start with a dot or have temporary extensions	[ ]
Check File Size	Verify the file is below the 250 GB upload threshold	[ ]