A group of Microsoft Products and technologies used for sharing and managing content, knowledge, and applications.
Hi @Zach
Thank you for reaching out and sharing the details regarding the sync issues affecting your company’s SharePoint document library. Below is a detailed step-by-step guide to help resolve the current problems and prevent similar issues in the future.
I. Common Causes of Sync Issues
- Large document library: Thousands of files and deeply nested folder structures can overwhelm the sync client.
- Network interruptions or offline work: These can lead to sync conflicts and the creation of duplicate folders.
- Inconsistent sync setup: Some users use “Sync” while others use “Add Shortcut to OneDrive,” causing confusion and redundant local copies.
- File names or paths are too long, or contain unsupported special characters.
- Outdated or stalled OneDrive client due to prolonged runtime or lack of updates.
II. Steps to Resolve Current Sync Issues
Step 1: Check Sync Status
- Look at the OneDrive icon in the system tray.
- If you see a red X or yellow exclamation mark → click to view the error.
- If the icon is missing → manually launch OneDrive.
Step 2: Verify Internet Connection and Login
- Ensure the PC has a stable internet connection.
- Confirm the user is signed in with the correct work account.
Step 3: Identify Problematic Files/Folders
- Use the “View sync problems” option in OneDrive.
- Compare the SharePoint web library with the local folder.
- Rename files flagged with “!” or those with long names/special characters.
Step 4: Pause and Resume Sync
- Right-click the OneDrive icon → “Pause syncing” → select 2 hours.
- After a few minutes → “Resume syncing.”
Step 5: Update the OneDrive Client
- Check and update OneDrive to the latest version via Microsoft Store or standalone installer.
- Restart the PC after updating.
Step 6: Unlink and Re-sync OneDrive
- Go to OneDrive Settings → Account tab → “Unlink this PC.”
- Sign in again and set up sync afresh.
- Recommendation: back up the old local folder before re-syncing to avoid duplication.
Step 7: Clean Up Duplicate Folders
- Compare contents of duplicate folders (e.g., “Projects” vs. “Projects-PCName”).
- Merge files into the main folder → delete the duplicate.
- Perform this while OneDrive is actively syncing to ensure changes are reflected in the cloud.
Step 8: Check Office Integration Settings
- Go to OneDrive Settings → Office tab → disable “Use Office applications to sync Office files that I open.”
- Restart OneDrive after making changes.
Step 9: Use Advanced Support Tools
- Use Microsoft Support and Recovery Assistant (SaRA) to diagnose issues.
- Admins can use the OneDrive Sync Health Dashboard to monitor sync errors across the organization.
III. Recommendations to Prevent Future Sync Issues
- Standardize the sync method: Use “Add Shortcut to OneDrive” for all users.
- Keep the library size manageable: Split large libraries or archive older content.
- Enable Files On-Demand: Reduces local storage usage and improves sync speed.
- Avoid invalid file names/paths: Apply consistent naming conventions.
- Restart OneDrive periodically: Prevents issues from long-running processes.
- Train users: Help them recognize and resolve duplicate folders, and avoid working offline for extended periods.
- Conduct regular audits: Admins should periodically review the SharePoint library to detect and resolve issues early.
If you have any updates regarding the issue after following the steps above, or if you have any questions during the process, please feel free to share them with me.
If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".
Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.