When you click the Files tab in a Teams channel, the tab may stay blank or show an error. This often happens when OneDrive sync is enabled on the same computer. The conflict comes from Teams trying to load the file view while OneDrive holds a lock on the same folders. This article explains why the conflict occurs and gives you step-by-step fixes to open the Files tab again.
The root cause is a file handle conflict. Teams uses the OneDrive sync engine to render the Files tab. If the sync client is paused, corrupted, or has too many pending changes, Teams cannot read the file list. You will see a spinning circle or a message that says “Something went wrong.”
Key Takeaways: Fix Teams Files Tab That Fails When OneDrive Sync Is On
- Pause OneDrive sync temporarily: Right-click the OneDrive cloud icon and choose Pause syncing to test if the Files tab loads.
- Reset the OneDrive app: Run the OneDrive reset command from the Run dialog to clear sync state without deleting files.
- Clear Teams cache: Delete the %appdata%\Microsoft\Teams folder contents to remove corrupted file view data.
Why the Teams Files Tab Fails When OneDrive Sync Is Enabled
Teams displays the Files tab by calling the SharePoint document library through the OneDrive sync engine. When you have OneDrive sync enabled, the same folders are also monitored by the sync client. If the sync client is busy, has a large queue, or has a file lock, Teams cannot get a timely response. The result is a blank tab or an error message.
Another common cause is a corrupted OneDrive cache. The cache stores metadata about synced files. If the cache becomes stale or damaged, the sync engine may return incomplete data to Teams. This can happen after a Windows update, a network change, or an interrupted sync process.
How OneDrive Sync Interacts with Teams Files
When you open a file from the Files tab, Teams uses the OneDrive sync client to download and open it. This works well when sync is idle. But if the sync client is running a large upload or download, it may block the Teams request. The block can last for seconds or minutes, causing the tab to time out.
Teams also uses a local cache for the file list. This cache is stored in the Teams app data folder. If the cache is corrupted, the Files tab may fail even when OneDrive sync is working normally.
Steps to Fix Teams Files Tab Not Opening with OneDrive Sync
Follow these steps in order. Test the Files tab after each step. Stop when the tab opens normally.
- Pause OneDrive sync temporarily
Right-click the OneDrive cloud icon in the system tray. Choose Pause syncing and select 2 hours. Open Teams and click the Files tab. If the tab loads, the sync engine was causing the conflict. Resume sync after the test. - Reset OneDrive without deleting files
Press Win + R to open the Run dialog. Typeonedrive /resetand press Enter. A command prompt window opens briefly. Wait for the OneDrive icon to reappear in the system tray. This clears the sync cache and reconnects to the cloud. Open Teams and test the Files tab. - Clear the Teams cache
Close Teams completely. Right-click the Teams icon in the system tray and choose Quit. Press Win + R, type%appdata%\Microsoft\Teams, and press Enter. Select all files in the folder and delete them. Do not delete the Teams folder itself. Restart Teams and sign in again. Test the Files tab. - Check for pending sync errors
Open OneDrive settings by right-clicking the cloud icon and choosing Settings. Go to the Sync and backup tab and click View sync problems. If there are errors, resolve them by moving or renaming the problem files. Then test the Files tab. - Run the Teams admin policy check
Open the Teams admin center at admin.teams.microsoft.com. Go to Teams apps and look for the Files app. Make sure the app is not blocked. If you are a user, contact your IT admin to verify the policy.
If Teams Still Has Issues After the Main Fix
Teams Files Tab Shows a Blank Window After OneDrive Reset
If the reset did not help, the Teams cache may still be corrupted. Repeat step 3 and also clear the browser cache if you use Teams on the web. For the desktop app, you can also try a full uninstall and reinstall of Teams.
OneDrive Sync Conflicts with Files Tab on Windows 10
Windows 10 sometimes has an older OneDrive version. Update OneDrive by opening Settings and checking for updates. Also, make sure your Windows 10 is fully updated. Old sync engine versions can cause more conflicts with Teams.
New Teams Desktop vs Teams on the Web: Key Differences for Files Tab
| Item | New Teams Desktop | Teams on the Web |
|---|---|---|
| Uses OneDrive sync engine | Yes | No |
| Cache location | %appdata%\Microsoft\Teams | Browser cache |
| File open speed | Faster after first load | Slower due to download |
| Conflict with OneDrive sync | Possible | Not applicable |
After following these steps, you should be able to open the Files tab without errors. Start by pausing OneDrive sync to confirm the conflict. Then reset OneDrive and clear the Teams cache for a permanent fix. If the issue persists, check for sync errors or contact your IT admin. As an advanced tip, you can also disable the OneDrive Files On-Demand feature temporarily to reduce file handle conflicts.