onedrive

OneDrive Stuck Processing Changes

Resolution Checklist

  • 1 Understand 'Processing Changes' Freezes
  • 2 Step 1: Locate and Delete Office Temporary Lock Files
  • 3 Step 2: Restart the Sync Client and Reset Local Database
  • 4 Step 3: Repair Folder and File Security Permissions
  • 5 Step 4: Check for Symbolic Links or Junction Points
  • 6 Summary Checklist

OneDrive Stuck Processing Changes

When Microsoft OneDrive gets stuck displaying “Processing changes” in the status panel, the sync engine is trapped in an infinite loop. It is scanning your local directories, but a specific file lock, permission block, or corrupted cache database is preventing it from completing the index.

This guide walks you through finding the offending files, repairing security permissions, and resetting the sync engine to get files moving again on Windows and macOS.

Understand ‘Processing Changes’ Freezes

When you add or edit a file, OneDrive scans its metadata and compares it to the cloud registry. This process can freeze if:

  • Office Lock Files: Microsoft Office applications create hidden temporary files starting with ~$ when documents are open. If Office crashes or fails to delete these files on close, OneDrive will try to sync them, but will be blocked by system-level locks.
  • Access Violations: The user account running OneDrive may not have Read/Write permissions for a folder it is trying to sync.
  • Unsupported Symlinks/Junctions: If you have manually created symbolic links, directory junctions, or aliases inside your OneDrive folder, the sync engine will get caught in circular reference loops.
  • Database Desynchronization: A crash or power outage can corrupt the SQL-based index file where OneDrive tracks sync tokens.

Step 1: Locate and Delete Office Temporary Lock Files

Office apps generate temporary files (e.g., ~$Document.docx). If these remain behind after an app closes, they freeze the sync queue.

On Windows (Delete via Command Prompt)

  1. Right-click the Start menu and select Command Prompt (Admin).
  2. Run this command to search for and force-delete all hidden Office temp files in your OneDrive directory: 
    del /f /s /q /a:h "%USERPROFILE%\OneDrive\~$*"
  3. Restart OneDrive and see if the sync resumes.

On macOS (Delete via Terminal)

  1. Open the Terminal app.
  2. Run this command to locate and purge temporary files in your OneDrive folder: 
    find ~/Library/CloudStorage/OneDrive-Personal -name "~\$*" -delete
    (Adjust the path name if you are using OneDrive for Business).

Step 2: Restart the Sync Client and Reset Local Database

If deleting temporary files does not release the sync queue, reset the local index databases.

Windows Command Suite

  1. Press Windows Key + R to open the Run box.
  2. Paste and run: 
    %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  3. If it fails, run: 
    C:\Program Files\Microsoft OneDrive\onedrive.exe /reset
  4. If OneDrive does not restart automatically after two minutes, open the Start menu, search for OneDrive, and launch it.

macOS Command Suite

  1. Open Terminal.
  2. Terminate the macOS FileProvider system daemon (which manages cloud folders in Finder): 
    killall -9 fileproviderd
  3. Execute the built-in OneDrive app reset tool: 
    /Applications/OneDrive.app/Contents/Resources/ResetOneDriveAppStandalone.command
  4. Log back in when prompted.

Step 3: Repair Folder and File Security Permissions

OneDrive must have full ownership of its root folder and all child directories to catalog changes.

Windows: Reset Folder Permissions with icacls

  1. Open Command Prompt (Admin).
  2. Grant your user account full control over the OneDrive directory structure and clear corrupted inheritance flags: 
    icacls "%USERPROFILE%\OneDrive" /grant "%USERNAME%":(OI)(CI)F /T /Q
    Explanation of flags: /grant gives Full access (F), (OI)(CI) inherits to subfolders/files, /T runs recursively, /Q suppresses success messages.

macOS: Repair Folder Permissions with chmod

  1. Open Terminal.
  2. Run this command to restore Read, Write, and Execute permissions for the owner across the OneDrive directory: 
    chmod -R u+rwX ~/Library/CloudStorage/OneDrive-Personal

OneDrive does not support symbolic links or folder junctions. If you try to map folders outside the OneDrive root into the folder via symlinks, OneDrive will freeze during indexing.

  • To find and remove symlinks on Windows: Open Command Prompt and list all junctions in your OneDrive directory: 
    dir /al /s "%USERPROFILE%\OneDrive"
    If any junctions are returned, delete the junction point (this deletes the shortcut, not the target files).
  • To find and remove symbolic links on macOS: Open Terminal and run: 
    find ~/Library/CloudStorage/OneDrive-Personal -type l
    If any paths are returned, delete the symlink via Finder or the rm command.

Summary Checklist

Action ItemTarget OSPurpose
Purge ~$* FilesWindows / macOSDeletes orphaned Microsoft Office temporary lock files stalling the engine.
Reset DatabaseWindows / macOSClears and rebuilds the local SQLite sync database.
Apply Permissions RepairWindows / macOSGrants the current user account full control permissions to sync files.
Remove SymlinksWindows / macOSEliminates unsupported directory junctions causing circular scan loops.