You open Finder on your Mac and expect to see OneDrive sync icons on your files and folders. Instead, the icons are missing, or you see generic icons that do not indicate the sync status. This problem occurs when the OneDrive Finder extension is disabled, not loaded, or has become corrupted after a macOS update or a OneDrive reinstall. This article explains why the extension fails to show its icons and provides the exact steps to reload, re-enable, or reinstall the extension so you can see sync status at a glance.
Key Takeaways: Restore OneDrive Sync Icons in Mac Finder
- Finder > System Settings > Privacy & Security > Extensions > Added Extensions: Enables the OneDrive Finder Extension that displays overlay icons on files and folders.
- OneDrive > Preferences > Account tab > Unlink this Mac: Resets the OneDrive sync relationship and forces a fresh extension registration.
- Terminal command: killall Finder: Restarts Finder after enabling the extension so that icon overlays appear immediately.
Why OneDrive Sync Icons Disappear in Mac Finder
OneDrive for Business on macOS uses a Finder Sync Extension to show overlay icons such as a green check mark, blue sync circle, or red exclamation point. These icons are not part of the OneDrive app itself — they are a separate component registered with macOS. When the extension is disabled, crashes, or fails to load after a macOS upgrade, the icons vanish even though OneDrive is still syncing files correctly.
Common triggers for this problem include:
- macOS updates that reset extension permissions
- OneDrive updates that do not re-register the extension
- Third-party utility apps that manage or disable system extensions
- Manual changes to System Settings > Privacy & Security > Extensions
The extension itself is a small bundle named OneDrive Finder Integration.appex located inside the OneDrive app package. If this bundle is missing or damaged, the icons cannot appear. The fix involves either enabling the extension through System Settings or reinstalling the extension component.
Steps to Enable the OneDrive Finder Extension and Restore Sync Icons
Follow these steps in order. Test after each step to see if the icons return. If they do not, proceed to the next step.
- Open System Settings and navigate to Extensions
Click the Apple menu and choose System Settings. Select Privacy & Security from the sidebar. Scroll down and click Extensions. In the Extensions pane, look for Added Extensions in the list on the left. Click it. - Enable the OneDrive Finder Extension
In the list of added extensions, locate OneDrive Finder Integration or OneDrive Sync. If the toggle switch next to it is off, click it to turn it on. If you do not see the extension at all, skip to step 4. - Restart Finder to apply the change
Open the Terminal app from Applications > Utilities. Type the following command and press Enter:killall Finder
Finder relaunches immediately. Check your OneDrive folder for sync icons. - Unlink and relink your OneDrive account
If the extension is missing or icons still do not appear, open OneDrive Preferences by clicking the OneDrive cloud icon in the menu bar, then clicking the gear icon and selecting Preferences. Go to the Account tab. Click Unlink this Mac. Confirm the action. OneDrive closes. Open OneDrive again from the Applications folder. Sign in with your work or school account. This process re-registers the Finder extension. - Reinstall OneDrive for Business
If unlinking does not work, download the latest version of OneDrive from the Microsoft 365 portal or from the Mac App Store. Quit OneDrive completely. Drag the OneDrive app from the Applications folder to the Trash. Empty the Trash. Restart your Mac. Install the fresh copy of OneDrive and sign in. The installer re-creates the Finder extension bundle.
If OneDrive Sync Icons Still Do Not Show After the Main Fix
OneDrive Finder Integration extension is grayed out in System Settings
A grayed-out toggle means the extension is present but macOS has flagged it as incompatible or disabled due to a security policy. This often happens after a macOS major update. To resolve this, open OneDrive and let it run for a few minutes. macOS sometimes re-enables the extension automatically after the app communicates with the system. If it remains grayed out, reinstall OneDrive as described in step 5 above. The reinstall forces macOS to re-evaluate the extension.
Only some files show sync icons while others show nothing
When icons appear on some files but not others, the extension is working, but the affected files may be stored in a location that OneDrive does not monitor. Verify that all files are inside the OneDrive folder. If you use multiple OneDrive accounts, only the primary account’s folder shows overlay icons by default. To enable icons for a secondary account, open OneDrive Preferences, select the account, and ensure the option “Show sync icons in Finder” is checked.
Icons appear briefly then disappear after a few seconds
This symptom indicates a conflict with another Finder extension, typically from Dropbox, Box, or Google Drive. Open System Settings > Privacy & Security > Extensions > Added Extensions and temporarily disable all third-party Finder extensions except OneDrive. Restart Finder using the killall Finder command. If the icons stay visible, re-enable the other extensions one at a time to identify the conflicting app.
OneDrive Finder Extension vs macOS File Provider Extension: Key Differences
| Item | OneDrive Finder Extension | macOS File Provider Extension |
|---|---|---|
| Purpose | Shows sync status overlay icons (green check, blue sync, red X) on files and folders in Finder | Manages cloud file access, on-demand downloads, and integration with the Finder sidebar |
| Installation method | Installed automatically with OneDrive for Business; registered via System Settings > Extensions | Built into macOS; activated when a cloud storage app uses the File Provider API |
| Common failure symptom | No overlay icons appear on files | Files show as placeholders but cannot open or download on demand |
| Recovery action | Enable extension in System Settings or reinstall OneDrive | Restart the Mac or reinstall the cloud storage app |
The Finder Extension only handles icon overlays and does not affect file syncing. If files sync correctly but icons are missing, focus on the extension steps above. If files do not sync at all, the issue is with the File Provider extension or the OneDrive sync engine itself.
You can now restore OneDrive sync icons in Mac Finder by enabling the extension in System Settings, unlinking and relinking your account, or reinstalling OneDrive if needed. After completing the fix, verify that the icons display consistently by opening a few folders and creating a new document inside OneDrive. To prevent future icon loss, avoid disabling system extensions with third-party utilities and always update OneDrive through the Mac App Store or the Microsoft 365 portal rather than through manual downloads.