Home › Knowledgebase › KB-745

How to fix Microsoft Teams failing to load files or documents from SharePoint and OneDrive

Summary

This guide helps you troubleshoot and resolve: How to fix Microsoft Teams failing to load files or documents from SharePoint and OneDrive. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

Microsoft Teams integrates with SharePoint and OneDrive to allow users to access, share, and collaborate on documents directly within channels and meetings. When these files fail to load, it is typically caused by authentication issues, outdated application caches, browser-related conflicts, or service interruptions. This guide provides steps to restore file access quickly for Australian small business users.

Determine the Scope of the Issue

Before troubleshooting, establish whether the problem affects one user or multiple users within your organisation.

Check Microsoft 365 Service Health

If multiple users cannot load files, verify there is no active outage with Microsoft 365 services.

  1. Open a web browser and navigate to admin.microsoft.com or status.office365.com.
  2. Sign in with your Microsoft 365 administrator credentials.
  3. Review the service health dashboard for any advisories or incidents affecting SharePoint Online or OneDrive for Business.
  4. If an active incident is reported, wait for Microsoft to resolve the issue before proceeding with local troubleshooting.

Quick Fix Steps

  1. Restart the Microsoft Teams application.
  2. Sign out of Teams and sign back in to refresh your authentication token.
  3. Check your internet connection, specifically ensuring you can access SharePoint and OneDrive domains.
  4. Try opening the specific file directly in SharePoint or OneDrive via your web browser.
  5. Determine if the issue occurs in the Teams desktop app, the Teams web app, or both.

Detailed Instructions

1. Check Internet Connectivity to SharePoint and OneDrive

General internet access does not guarantee connectivity to Microsoft cloud services. Verify you can reach the specific domains Teams relies on.

  1. Open Microsoft Edge or Google Chrome.
  2. Navigate to office.com and sign in with your work or school account.
  3. Open OneDrive or SharePoint from the app launcher.
  4. Attempt to open the document that was failing to load in Teams.

If the file opens in the browser but not in Teams, the issue is isolated to the Teams application. If the file does not open in the browser either, there may be a permissions issue with the SharePoint or OneDrive site.

2. Check OneDrive Sync Client Status

Teams relies on the OneDrive sync client for file access. If OneDrive is not running or signed in, files may fail to load.

  1. Look for the OneDrive cloud icon in the Windows system tray or Mac menu bar.
  2. If the icon is missing, open the OneDrive application from your Start menu or Applications folder.
  3. Sign in with your work or school account if prompted.
  4. Wait for OneDrive to finish synchronising, then return to Teams and attempt to load the files again.

3. Clear the Teams Cache

Corrupted local cache files often prevent Teams from synchronising with SharePoint and OneDrive.

Windows

  1. Completely close Microsoft Teams. Right-click the Teams icon in the system tray and select Quit to ensure it is not running in the background.
  2. Press Windows Key + R to open the Run dialog.
  3. Type %appdata%\Microsoft\Teams and press Enter.
  4. Select all files and folders in this directory and delete them.
  5. Restart Microsoft Teams and attempt to load the files again.

Mac

  1. Completely quit Microsoft Teams. Right-click the Teams icon in the Dock and select Quit, or press Command + Q.
  2. Open Finder and select Go from the menu bar, then choose Go to Folder.
  3. Enter ~/Library/Application Support/Microsoft/Teams and press Return.
  4. Select all files and folders in this directory and move them to the Trash.
  5. Empty the Trash, then restart Microsoft Teams.

4. Update Microsoft Teams

Modern versions of Microsoft Teams update automatically. You do not need to manually check for updates within the app.

  1. Close Microsoft Teams completely.
  2. Allow the application to update automatically the next time you launch it.
  3. If you are using an older version managed by your organisation, check the Microsoft Store for available updates or contact your IT administrator to ensure you are on the latest build.
  4. Restart Teams after any update is installed.

5. Check for Checked Out or Locked Files

A file may fail to load if it is checked out or locked by another user in SharePoint.

  1. Open the file directly in SharePoint or OneDrive via your web browser.
  2. Look for indicators showing the file is checked out or locked by another user.
  3. If the file is checked out, ask the user who has it checked out to check it back in, or discard their check-out if appropriate.
  4. Return to Teams and refresh the file view.

6. Test Teams Web App vs Desktop App

Isolating the issue to a specific Teams client helps determine whether the problem is application-wide or account-related.

  1. Open a web browser and navigate to teams.microsoft.com.
  2. Sign in with your organisational credentials.
  3. Access your channels and files through the browser interface.
  4. If files load in the web app but not the desktop app, the issue is isolated to the Teams desktop application. Proceed with cache clearing and reinstallation steps.

7. Mobile App Troubleshooting

If you are experiencing file loading issues on the Teams mobile app, follow these steps.

  1. Force close the Teams app on your iOS or Android device.
  2. Reopen the app and sign in again.
  3. Check for updates in the Apple App Store or Google Play Store and install any available updates for Microsoft Teams.
  4. If the issue persists, uninstall the Teams mobile app, restart your device, and reinstall the app from your device's app store.

8. Permission Errors

If you see a "You don't have access to this file" message, the file owner may have restricted permissions.