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.
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.
- Single user affected: The issue is likely local to that device or user account. Follow the detailed steps below.
- Multiple users affected: This suggests a service outage or a permission issue at the SharePoint or OneDrive site level. Check service health first, then contact the file owner or your IT administrator.
Check Microsoft 365 Service Health
If multiple users cannot load files, verify there is no active outage with Microsoft 365 services.
- Open a web browser and navigate to
admin.microsoft.comorstatus.office365.com. - Sign in with your Microsoft 365 administrator credentials.
- Review the service health dashboard for any advisories or incidents affecting SharePoint Online or OneDrive for Business.
- If an active incident is reported, wait for Microsoft to resolve the issue before proceeding with local troubleshooting.
Quick Fix Steps
- Restart the Microsoft Teams application.
- Sign out of Teams and sign back in to refresh your authentication token.
- Check your internet connection, specifically ensuring you can access SharePoint and OneDrive domains.
- Try opening the specific file directly in SharePoint or OneDrive via your web browser.
- 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.
- Open Microsoft Edge or Google Chrome.
- Navigate to
office.comand sign in with your work or school account. - Open OneDrive or SharePoint from the app launcher.
- 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.
- Look for the OneDrive cloud icon in the Windows system tray or Mac menu bar.
- If the icon is missing, open the OneDrive application from your Start menu or Applications folder.
- Sign in with your work or school account if prompted.
- 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
- 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.
- Press
Windows Key + Rto open the Run dialog. - Type
%appdata%\Microsoft\Teamsand pressEnter. - Select all files and folders in this directory and delete them.
- Restart Microsoft Teams and attempt to load the files again.
Mac
- Completely quit Microsoft Teams. Right-click the Teams icon in the Dock and select Quit, or press
Command + Q. - Open Finder and select Go from the menu bar, then choose Go to Folder.
- Enter
~/Library/Application Support/Microsoft/Teamsand pressReturn. - Select all files and folders in this directory and move them to the Trash.
- 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.
- Close Microsoft Teams completely.
- Allow the application to update automatically the next time you launch it.
- 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.
- 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.
- Open the file directly in SharePoint or OneDrive via your web browser.
- Look for indicators showing the file is checked out or locked by another user.
- 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.
- 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.
- Open a web browser and navigate to
teams.microsoft.com. - Sign in with your organisational credentials.
- Access your channels and files through the browser interface.
- 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.
- Force close the Teams app on your iOS or Android device.
- Reopen the app and sign in again.
- Check for updates in the Apple App Store or Google Play Store and install any available updates for Microsoft Teams.
- 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.
- Contact the person who shared the document to request access to the folder or file.
- If you are the file owner, verify sharing settings in SharePoint or OneDrive to ensure the intended users have access.
If you have completed these steps and are still unable to load files from SharePoint or OneDrive, please Open a Ticket with our support team.
Still Having Issues?
💻 Open a Ticket