Mac users report that files synced with the OneDrive sync client for SharePoint libraries fail to open. The file icon appears with a gray X or a lock symbol, and double-clicking produces no response or an error message. This problem typically occurs when the sync client loses connection to the SharePoint server or when file permissions block local access. This article explains the root causes from the site owner perspective and provides the exact settings to verify and fix.
Key Takeaways: What Site Owners Must Check for Mac Sync Issues
- SharePoint admin center > Sync settings: Verify that the OneDrive sync client is allowed for the tenant and that sync restrictions are not blocking the site.
- Site collection > Site permissions: Confirm that the affected Mac user has at least Read access to the library and that the user is not blocked by a sharing policy.
- Library settings > Require Check Out: Disable this setting if users cannot open files even after syncing, because the sync client does not handle checkout workflows.
Why the Mac Sync Client Cannot Open SharePoint Files
The OneDrive sync client for Mac (formerly known as the OneDrive standalone app) connects to SharePoint document libraries using the Microsoft Graph API. When a file fails to open, the root cause is usually one of the following three conditions:
1. Sync Client Blocked at the Tenant Level
A SharePoint admin may have disabled the OneDrive sync client for the entire tenant. When this setting is off, the Mac sync client can still download the file metadata but cannot obtain the actual file content. The user sees the file in Finder but cannot open it.
2. Permissions Mismatch Between SharePoint and the Sync Client
The sync client caches the user token after the initial sign-in. If the site owner changes the user permissions after the sync is established, the client may still hold the old token. The file appears in the local folder but the server denies the read request when the user tries to open it.
3. File Check-Out or Lock State
SharePoint supports a Require Check Out feature that locks files in the library until a user checks them in. The Mac sync client does not support file check-out workflows. If a file is checked out by another user or by the system, the sync client downloads a placeholder that cannot be opened.
Steps to Fix Mac Sync Client File Access Issues
Perform these checks in the SharePoint admin center and the site collection settings. You need SharePoint admin or site collection owner permissions.
- Check tenant sync settings
Open the SharePoint admin center. Go to Settings > Sync. Ensure the toggle for OneDrive sync client is set to Allow syncing. If it is set to Block syncing, change it to Allow syncing and click Save. Wait 15 minutes for the change to propagate. - Verify site-level sync permissions
In the SharePoint admin center, select Active sites. Find the affected site and click on it. In the site details panel, look at the External sharing setting. If the site is set to Only people in your organization, Mac users who are guests or external users will be blocked. Change the setting to Anyone with a link that does not require sign-in temporarily for testing, then revert after the issue is resolved. - Check library permissions for the Mac user
Open the document library. Click the gear icon and select Library settings. Click Permissions for this document library. Verify that the Mac user account appears in the list with at least Read permission. If the user is missing, click Grant Permissions and add the user. - Disable Require Check Out
In Library settings, click Versioning settings. Under Require Check Out, select No. Click OK. Existing checked-out files will remain locked until they are checked back in. Ask users to check in their files manually. - Reset the sync client cache on the Mac
On the affected Mac, quit OneDrive. Open Finder and press Cmd+Shift+G. Type ~/Library/CloudStorage and press Enter. Delete the folder corresponding to the SharePoint site. Restart OneDrive and let it re-sync. This forces a fresh token and removes stale placeholders. - Re-add the library in OneDrive preferences
Open OneDrive preferences on the Mac. Go to the Account tab. Click Choose Folders. Uncheck the affected library and click OK. Wait for the sync to stop. Go back to Choose Folders and re-check the library. This triggers a full re-sync.
If SharePoint Files Still Do Not Open on Mac
Mac User Sees a Lock Icon on All Files
A lock icon on every file in the synced folder indicates that the user has View Only permissions or the library is set to Read only. The site owner should change the user permission to Edit or Contribute. In Library settings, click Permissions for this document library, select the user, and click Edit User Permissions. Change from Read to Contribute.
Error Message: “You Do Not Have Permission to Open This File”
This error appears when the sync client token has expired but the user is still signed in. The fix is to sign out of OneDrive on the Mac and sign in again. Open OneDrive preferences, click Account, click Unlink this Mac. Restart OneDrive and sign in again with the same work or school account.
Files Open in the Browser But Not From Finder
This symptom means the file is synced correctly but the default app association is broken. The site owner can instruct the Mac user to right-click the file in Finder, select Open With, and choose the correct application. To set the default for all files of that type, select Always Open With.
OneDrive Sync Client vs Browser Access: Key Differences
| Item | OneDrive Sync Client on Mac | Browser Access to SharePoint |
|---|---|---|
| File check-out support | Not supported; cannot open checked-out files | Supported; can open and edit checked-out files |
| Permission changes after sync | May cache old permissions; requires cache reset | Respects current permissions immediately |
| Offline access | Files are available offline after sync | No offline access without sync client |
| File size limit | 250 GB per file | 2 GB per file for upload; no limit for download |
| Authentication refresh | Token expires after 90 days; requires re-sign-in | Token refreshes automatically during session |
Now you can identify why the Mac sync client cannot open SharePoint files and apply the correct fix. Start by checking the tenant sync settings in the SharePoint admin center. Then verify the library permissions and disable Require Check Out if necessary. For persistent issues, reset the sync client cache on the Mac. As an advanced tip, use the SharePoint admin center Reports > OneDrive usage report to identify which sites have the highest sync failure rate.