Mac Sync Client Cannot Open SharePoint Files: Root Cause and Fix

You try to open a SharePoint file from Finder on your Mac, but nothing happens. The file appears in the synced OneDrive folder, but double-clicking it does not launch the application. This problem usually occurs because the OneDrive sync client for Mac uses a placeholder system that can break file associations or because the file is still in a pending sync state. This article explains the technical reasons behind the failure and provides step-by-step fixes to restore normal file opening behavior.

Why the Mac Sync Client Fails to Open SharePoint Files

The OneDrive sync client for macOS uses a feature called Files On-Demand. This feature stores only placeholder metadata on your local drive while the full file content remains in the cloud. When you double-click a file, macOS asks the sync client to download the real file and then open it with the default application. If any part of this chain breaks, the file will not open.

Three common root causes exist:

Corrupted Placeholder Files

When a placeholder file becomes corrupted, macOS sees a zero-byte file or a file with an incorrect UTType identifier. The operating system cannot determine which application should handle the file, so it does nothing. This corruption can happen after a sync conflict, an interrupted download, or a macOS update that changes file handling rules.

Broken File Associations

Each file type on macOS has a default application registered in Launch Services. If another application claims that file type during an update or if you manually change the default, the sync client may not be able to invoke the correct app. For example, if a PDF file is set to open with a browser instead of Preview, the browser might ignore the file because it is still a placeholder.

Stale Sync State

A file that appears in Finder but is still marked as pending sync by OneDrive will not open. The sync client reports the file as available, but the placeholder has not been fully hydrated. This state often occurs when the sync engine is paused, when network connectivity is intermittent, or when the file is locked by another process.

Steps to Fix SharePoint Files That Will Not Open on Mac

Follow these steps in order. Test the file after each step to see if the issue is resolved.

1. Force download the file
   Right-click the file in Finder and select Always keep on this device. This forces OneDrive to download the full file content. Wait for the green checkmark icon to appear. If the file still does not open, proceed to step 2.
2. Check file association in Get Info
   Right-click the file and select Get Info. Look at the Open with section. If the application shown is incorrect or blank, choose the correct app from the dropdown menu. Click Change All to apply the change to all files of this type.
3. Reset Files On-Demand
   Open OneDrive Preferences by clicking the OneDrive icon in the menu bar, selecting Preferences, then going to the Sync tab. Uncheck Files On-Demand. Wait 10 seconds, then recheck it. OneDrive will regenerate the placeholder files. Restart Finder by opening Terminal and typing killall Finder then pressing Enter.
4. Pause and resume sync
   Click the OneDrive icon in the menu bar. Click Pause syncing and choose 2 hours. Wait 30 seconds, then click the OneDrive icon again and select Resume syncing. This forces a full refresh of the sync state for all files.
5. Reinstall OneDrive
   If the above steps fail, uninstall OneDrive from the Applications folder. Restart your Mac. Download the latest OneDrive for Mac installer from the Microsoft website. Install and sign in again. This rebuilds the sync engine and all file associations from scratch.

If SharePoint Files Still Have Issues After the Main Fix

SharePoint File Opens as Blank or Unreadable Content

This symptom means the placeholder file was hydrated but the download was incomplete. Open OneDrive Preferences and go to the Network tab. Increase the download bandwidth limit to Unlimited. Then use the Always keep on this device option again. If the problem persists, the file may have a corruption in the cloud version. Open the file directly in a browser via SharePoint to check its integrity.

SharePoint File Shows a Red X or Error Icon

A red X icon indicates a sync conflict or a blocked file. Right-click the file and select View sync conflicts. Resolve any conflicts by choosing which version to keep. If no conflicts appear, check the OneDrive Activity Center for error messages. Common messages include File path too long or File name contains invalid characters. Rename the file to remove special characters and shorten the path.

SharePoint Folder Does Not Sync at All

If an entire folder of SharePoint files never appears in Finder, the sync relationship may be broken. Open OneDrive Preferences and go to the Account tab. Click Choose folders under your work or school account. Ensure the SharePoint site and library are checked. Uncheck and recheck the library to force a resync. This process downloads all placeholders again.

Item	Files On-Demand Enabled	Files On-Demand Disabled
Description	Placeholder files only; content downloads on demand	Full file content always stored locally
Disk space usage	Low	High
File opening speed	Slow on first open; fast after hydration	Fast on every open
Best for	Users with limited local storage	Users who need offline access to all files

Now you can resolve the Mac sync client issue where SharePoint files do not open. Start with the force download step and check the file association in Get Info. If the problem continues, reset Files On-Demand and restart Finder. For persistent errors, consider disabling Files On-Demand entirely to keep full file copies on your Mac. This approach eliminates placeholder corruption as a cause.