onedrive

OneDrive Shared Folder Not Syncing

Resolution Checklist

  • 1 Understand How OneDrive Handles Shared Folders
  • 2 Step 1: Add the Shared Folder Shortcut to 'My Files'
  • 3 Step 2: Enable the Folder in OneDrive 'Choose Folders' Settings
  • 4 Step 3: Verify Folder Access Permissions and Owner Settings
  • 5 Step 4: Clear Sync Client Cache to Force a Refresh
  • 6 Summary Checklist

OneDrive Shared Folder Not Syncing

When a colleague shares a folder with you in Microsoft OneDrive, it may show up on the web portal but fail to synchronize to your local computer’s Explorer (Windows) or Finder (macOS) directories.

This happens because OneDrive does not sync shared folders to your local computer by default. You must explicitly add a shortcut to your personal directory, verify account permissions, and configure selective sync.

Understand How OneDrive Handles Shared Folders

Shared folders behave differently than folders you create yourself. Common failure points include:

  • Missing Shortcuts: Unless you click “Add shortcut to My files” in the web interface, the OneDrive desktop sync engine completely ignores the shared folder.
  • Permission Revocation: If the owner revokes your edit permissions or deletes the shared folder, the local copy will stop syncing and may display access-denied errors.
  • Tenant/Admin Restrictions: Organizations often implement security policies restricting external users (guest accounts) from syncing shared directories locally.
  • Selective Sync Exclusions: The shared shortcut may have been added online but unchecked in your local desktop client’s folder options.

Step 1: Add the Shared Folder Shortcut to ‘My Files’

To make a shared folder eligible for local synchronization, you must bind it to your drive root via the web browser.

  1. Open your web browser and sign in to the OneDrive Web Portal.
  2. In the left navigation pane, click on Shared.
  3. Locate the folder you want to sync and click the three vertical dots (More options) next to the folder name, or select the folder.
  4. Click Add shortcut to My files from the top menu bar or context menu.
  5. The folder will now appear in your main directory with a small link icon on the folder, indicating it is a shortcut. The desktop app will automatically start syncing it.

[!WARNING] Do not click “Copy to my OneDrive” instead of “Add shortcut”. Copying creates a static snapshot of the files, which does not sync live changes made by other collaborators.

Step 2: Enable the Folder in OneDrive ‘Choose Folders’ Settings

If the shortcut is added but still doesn’t appear on your machine, check your client’s Selective Sync configuration.

On Windows:

  1. Click the OneDrive cloud icon in your system tray.
  2. Select Settings (Gear Icon) → Settings.
  3. Go to the Account tab and click the Choose folders button.
  4. Locate the shared shortcut folder name in the list. Ensure the checkbox next to it is checked.
  5. Click OK to apply and trigger the download.

On macOS:

  1. Click the OneDrive cloud icon in your Mac menu bar.
  2. Click the gear icon and select Settings.
  3. Under the Account tab, click Choose folders.
  4. Check the box next to your shared folder shortcut. Click OK.

Step 3: Verify Folder Access Permissions and Owner Settings

If synchronization suddenly stops, the folder owner may have updated the access control list (ACL):

  1. Go to your OneDrive Web Portal and click Shared -> Shared with you.
  2. If the folder is missing, the owner has removed your access.
  3. If the folder is visible, open it and try to upload a dummy text file.
  4. If you receive an “Access Denied” or “Read-Only” warning, you cannot sync local edits. You must contact the owner to restore Can Edit permissions.

Step 4: Clear Sync Client Cache to Force a Refresh

If the shortcut is correctly set up and checked but refuses to update locally, resetting the sync client will force OneDrive to re-index all shortcuts.

Windows Reset Commands

Run the following commands in Command Prompt to force terminate and reset OneDrive:

:: Kill the desktop sync client
taskkill /f /im onedrive.exe

:: Run the reset command to clean database and check shortcuts
%localappdata%\Microsoft\OneDrive\onedrive.exe /reset

Note: If %localappdata% is not found, use C:\Program Files\Microsoft OneDrive\onedrive.exe /reset.

macOS Reset Commands

Run the following command in Terminal to clear the OneDrive local cache:

# Force macOS file provider daemon restart
killall -9 fileproviderd

# Execute the local client reset script
/Applications/OneDrive.app/Contents/Resources/ResetOneDriveAppStandalone.command

Summary Checklist

Action ItemTarget PlatformDescription
Add Shortcut to My FilesWeb BrowserCrucial first step; tells OneDrive to sync the folder locally.
Verify Choose FoldersWindows / macOSConfirms the shared folder hasn’t been unchecked in selective sync.
Check Edit PermissionsWeb BrowserEnsures the owner hasn’t changed your permission status to read-only.
Run Cache ResetWindows / macOSResolves sync engine freeze-ups that prevent folder shortcuts from updating.