Home › Knowledgebase › KB-340

How to fix Microsoft Teams not syncing or showing the latest files from SharePoint and OneDrive

Summary

This guide helps you troubleshoot and resolve: How to fix Microsoft Teams not syncing or showing the latest files from SharePoint and OneDrive. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

When Microsoft Teams, SharePoint, and OneDrive stop syncing properly, your team can end up working on outdated documents or missing recent changes altogether. This is one of the most common frustrations for businesses using Microsoft 365, and the good news is that it's usually fixable without needing to escalate to Microsoft directly. This guide walks you through the most effective troubleshooting steps, starting with the quickest fixes and moving into more detailed solutions.

Quick Fix Steps

Before diving into detailed troubleshooting, try these fast solutions that resolve the majority of syncing issues:

  1. Sign out and back into Teams. Click your profile picture in the top-right corner of Teams, select Sign out, close the app completely, then sign back in.
  2. Restart the OneDrive desktop app. Click the OneDrive cloud icon in your system tray (Windows) or menu bar (Mac), select the gear icon, then choose Quit OneDrive. Reopen it from the Start menu or Applications folder.
  3. Check your internet connection. A flaky network is the most common cause of sync delays. Try loading a webpage or running a speed test to confirm your connection is stable.
  4. Wait 10 to 15 minutes. Microsoft 365 sync can lag during peak usage times. If the issue just started, give it a few minutes before making changes.

NOTE: If the quick fixes don't resolve the issue, move on to the detailed instructions below.

Detailed Instructions

Step 1: Verify the File is Stored in SharePoint or OneDrive

Teams only syncs files that are stored in the correct location. Files uploaded directly into a chat conversation are stored in a different place than files in a channel's Files tab.

  1. Open the affected channel in Teams.
  2. Click the Files tab at the top of the channel.
  3. Confirm the file you're looking for is listed there.
  4. If it isn't, navigate to office.com, open OneDrive or SharePoint, and check whether the file exists in the correct library.

WARNING: Files attached directly to a chat message (rather than uploaded to a channel) are stored in the sender's OneDrive and may not sync to other users in real time.

Step 2: Update the OneDrive Desktop App

An outdated OneDrive client is a frequent cause of sync failures. Microsoft releases updates regularly to address known issues.

  1. Click the OneDrive cloud icon in your system tray or menu bar.
  2. Select the gear icon, then choose Settings.
  3. Go to the About tab.
  4. You'll see your current version. Click Download the latest version if an update is available.
  5. Install the update and restart your computer.

Step 3: Reset the OneDrive Desktop App

If updating doesn't help, resetting OneDrive can clear corrupted cache files without deleting your actual data.

  1. Close OneDrive completely (right-click the cloud icon and choose Quit OneDrive).
  2. Open a command prompt or terminal window.
  3. For Windows, type: %localappdata%\Microsoft\OneDrive\onedrive.exe /reset
  4. For Mac, type: killall OneDrive followed by reopening OneDrive from the Applications folder.
  5. Wait for OneDrive to restart and resync your files.

NOTE: Resetting OneDrive does not delete your files. It only clears the local cache and re-establishes the connection to Microsoft's servers.

Step 4: Clear the Teams Desktop Cache

Teams stores temporary data locally that can become corrupted. Clearing the cache forces Teams to rebuild its connection to SharePoint and OneDrive.

  1. Fully quit Teams. On Windows, right-click the Teams icon in the system tray and select Quit. On Mac, use Cmd + Q.
  2. Open File Explorer (Windows) or Finder (Mac).
  3. Navigate to the following folder:
    • Windows: %appdata%\Microsoft\Teams
    • Mac: ~/Library/Application Support/Microsoft/Teams
  4. Delete the contents of the following subfolders: Cache, blob_storage, databases, GPUCache, IndexedDB, Local Storage, and tmp.
  5. Restart Teams and sign back in.

WARNING: Do not delete the entire Teams folder, only the subfolders listed above. Deleting other files may cause you to lose settings or require a full reinstall.

Step 5: Check SharePoint Directly for Sync Issues

If a specific channel's Files tab isn't updating, verify the file status directly in SharePoint rather than making dummy edits to trigger a sync.

  1. Open the affected channel in Teams.
  2. Click the Files tab.
  3. Click Open in SharePoint at the top of the page.
  4. Locate the file in the SharePoint document library.
  5. Check whether the file appears with the most recent timestamp and content.
  6. If the file is missing or outdated in SharePoint, the issue is with the upload source, not Teams.
  7. Return to Teams and refresh the Files tab (Ctrl + R on Windows or Cmd + R on Mac).

Step 6: Check Microsoft 365 Service Health

Sometimes the issue is on Microsoft's end. Check whether there are known outages affecting SharePoint, OneDrive, or Teams.

  1. Non-admin users should first visit status.office.com for public service health information.
  2. If you have administrator access, go to admin.microsoft.com.
  3. Navigate to Health > Service health.
  4. Look for any active incidents affecting SharePoint Online, OneDrive for Business, or Microsoft Teams.
  5. If you're not an admin and the public status page shows no issues, contact your IT administrator to check the admin centre on your behalf.

Troubleshooting

File Size Limits and Blocked File Types

OneDrive and SharePoint have strict limits on individual file sizes. A single file cannot exceed 250GB. If you are trying to sync a file larger than this limit, it will fail. Additionally, certain file types are blocked for security reasons. Common blocked extensions include .tmp, .ds_store, and temporary Office files starting with ~$. If your file exceeds the size limit or uses a blocked type, compress the file, split it into smaller parts, or rename it to an allowed extension before attempting to sync again.

Storage Quota Exceeded

If your OneDrive or SharePoint storage quota is full, new files will not sync. Check your available storage by signing into office.com, opening OneDrive, and reviewing the storage indicator in the bottom-left corner. If you are at capacity, delete unnecessary files, empty the recycle bin, or request additional storage from your IT administrator.

Files Checked Out or Locked by Another User

In SharePoint, files can be checked out to a specific user, which prevents others from editing or syncing changes. Open the file library in SharePoint, look for the green check-out arrow icon next to the file name, and check who has the file locked. Ask that user to check the file back in, or discard the check-out if they are no longer working on it.

Guest and External User Access

Guest or external users may experience sync limitations depending on your organisation's sharing policies. External users cannot sync SharePoint libraries to their OneDrive desktop app in the same way internal users can. If a guest user cannot see the latest files, ask them to access the files through the Teams web browser or the SharePoint web interface rather than the desktop sync client.

Conditional Access and MFA Blocks

Conditional Access policies or multi-factor authentication (MFA) requirements can block sync for business accounts if the device is not compliant or if authentication has expired. If you are repeatedly prompted to sign in or receive access denied errors, sign out of OneDrive and Teams completely, then sign back in and complete the MFA challenge. Contact your IT administrator if your device is blocked by Conditional Access.

Mobile App Sync Issues (iOS and Android)

If files are not syncing in the Teams mobile app, ensure you are using the latest version from the App Store or Google Play. Force close the app and reopen it. Check that you have granted the app permission to access files and storage. For large libraries, sync may take longer on mobile networks. Switch to a stable Wi-Fi connection and allow additional time for files to appear.

Licensing and Permissions

Confirm that your user account has an active Microsoft 365 licence that includes SharePoint and OneDrive for Business. Users without the correct licence will not be able to sync files. Check with your IT administrator to verify your licence status and permissions for the affected SharePoint site or OneDrive library.

Files Show "Syncing" But Never Complete

This usually indicates a conflict or a file path that's too long. Try the following:

Files Appear in OneDrive but Not in Teams

If you've uploaded files directly to a SharePoint document library rather than through Teams, they should still appear in the channel's Files tab. If they don't:

Changes Made Offline Aren't Appearing for Other Users

If you've been working offline and your changes aren't syncing:

Teams Web Version Works but Desktop Doesn't

If files sync correctly when you use Teams in your browser but not in the desktop app, the issue is almost certainly with your local Teams installation. Repeat Step 4 (clearing the Teams cache) and, if that doesn't help, uninstall and reinstall the Teams desktop client from microsoft.com.

If you have completed all the steps above and your files still aren't syncing between Teams, SharePoint, and OneDrive, please open a support ticket via the Open a Ticket portal. Include details of the affected files, any error messages you're seeing, and the troubleshooting steps you've already tried.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket