Forum Discussion

rottmannventures's avatar
rottmannventures
Copper Contributor
Sep 25, 2025

How to resolve "Fix folder issues to sync x items"?

OneDrive for Business 25.170 (September 2025) for macOS Sequoia. When I click the OneDrive icon in the menu bar, the popup shows "Fix folder issues to sync 108 items.". Clicking not he message does take me to the root OneDrive for Business folder on macOS - not to the individual items. Also, due to the limited size of the UI - which cannot be expanded - the full path names appear shortened, making it difficult to identify the one which are causing problems. (It is somewhat difficult to understand, who comes up with such an unusable user interface design decision for something as important as potential sync issues, but that is a completely different topic.)

Any help how to resolve these issues would be greatly appreciated.

 

files
Sync

1 Reply

  • NikolinoDE's avatar
    NikolinoDE
    Gold Contributor
    Sep 26, 2025

    That message (“Fix folder issues to sync 108 items”) generally indicates that some files or folders under your OneDrive (or OneDrive for Business) sync tree are failing to sync correctly. Possible causes include:

    • Filename or path length conflicts, or illegal characters
    • Permissions (OneDrive can’t access or write to them)
    • The item is on a removed/externally unmounted volume
    • Conflicts or inconsistencies in the local file database
    • Storage limits, quotas, or file-locking
    • OneDrive internal corruption or cache issues

    Microsoft’s advice includes unlinking/relinking or resetting OneDrive.

    Fix OneDrive sync problems on Mac

    But before you do that, it’s often better to identify which specific items are causing the trouble and fix just those.

    1. Try to locate a few of those problematic file names (like pj-93-book-04.jpg) in Finder / Terminal
    2. Inspect their permissions, locked status, path, parent folders
    3. Rename / temporarily move them to test if they clear the sync error
    4. If that doesn’t help, back up your local OneDrive folder (just in case), then unlink + re-link, or reset OneDrive
    5. After re-syncing, re-add subfolders gradually
    6. If errors reappear, check logs to see which new files are failing

     

    My answers are voluntary and without guarantee!

     

    Hope this will help you.

     

    Was the answer useful? Mark as best response and like it!

    This will help all forum participants.

Resources