Fix Teams File Shows Access Denied with OneDrive Sync Enabled

When your Teams file shows Access Denied even though OneDrive sync is enabled, the culprit is usually a conflict between the sync engine and Teams permissions. OneDrive sync can lock files or apply restrictive sharing settings that Teams does not recognize. This article explains why the denial happens and gives you step-by-step fixes to restore access quickly. You will learn how to check sync status, adjust sharing settings, and reset the sync relationship if needed.

Why Teams Shows Access Denied When OneDrive Sync Is Enabled

When you sync a Teams channel’s files to your computer via OneDrive, the sync client creates a local copy and keeps it in sync with SharePoint. Access Denied can appear for several reasons. The most common is that the sync engine holds a lock on the file, preventing Teams from opening it directly. Another frequent cause is a mismatch between the file’s sharing permissions and the user’s role in the channel. If the file was shared with a specific person or group, and that person is not a member of the channel, Teams will block access even though the sync is working.

The sync client can also cache stale permissions. When the owner changes sharing settings, the sync client may not update immediately. This delay causes the file to appear as Access Denied in Teams until the next sync cycle. Finally, if the file is marked as sensitive or restricted by a data loss prevention policy, Teams will enforce that policy and deny access regardless of sync status.

How OneDrive Sync Affects Teams Permissions

OneDrive sync does not change the actual SharePoint permissions. It only creates a local replica. However, the sync client can interfere with Teams’ ability to open files because it may think the file is still being uploaded or downloaded. When you click a file in Teams, the app tries to read the file from SharePoint, not from your local sync folder. If the sync client has a pending operation, Teams may receive a temporary denial.

Another angle is the ‘Check Out’ feature. If someone has checked out the file in SharePoint, it becomes locked. OneDrive sync will still show the file as available, but Teams will deny access because the file is checked out. This is a common scenario in organizations that use document versioning.

Steps to Diagnose and Fix Access Denied in Teams Files

Follow these steps in order. Each step addresses a different cause. You can stop when the file opens normally.

1. Check the file status in Teams
   Open Teams and go to the Files tab of the channel. Look for a lock icon or a red circle with a cross. A lock means the file is checked out. A red circle means the sync has an error. Right-click the file and select ‘Open in SharePoint’. If the file opens in the browser, the problem is with the sync client, not the permissions.
2. Verify your role in the channel
   If you are a guest or an external user, confirm that you have the correct role. Go to the channel and click the ellipsis (three dots) next to the channel name. Select ‘Manage channel’. In the Members tab, check your role. If you are a guest, you may not have permission to open certain files. Ask the channel owner to grant you ‘Member’ or ‘Owner’ role.
3. Check the SharePoint sharing settings
   Go to the SharePoint site that hosts the channel files. Click the gear icon and select ‘Site permissions’. Then click ‘Sharing settings’. Ensure that the sharing level allows access for the users who need it. If the site is set to ‘Only owners can share’, then only owners can share files with others. Change it to ‘Site members can share’ or ‘Anyone with the link’ if appropriate.
4. Stop sync and resync the folder
   In your system tray, click the OneDrive cloud icon. Select ‘Settings’ and go to the ‘Account’ tab. Click ‘Stop sync’ next to the SharePoint document library that contains the file. Wait a few minutes, then click ‘Start sync’ again. This resets the sync relationship and clears any stale locks.
5. Clear the OneDrive cache
   If the problem persists, clear the OneDrive cache. Press Ctrl+R to open the Run dialog, type %localappdata%\Microsoft\OneDrive\cache, and press Enter. Delete all files in that folder. Then restart OneDrive by right-clicking the cloud icon and selecting ‘Exit’. Reopen OneDrive from the Start menu.
6. Check for checked-out files
   If the file is checked out, you must ask the person who checked it out to check it back in. In SharePoint, go to the document library, hover over the file, click the ellipsis, and select ‘More’ then ‘Check in’. If you are the one who checked it out, you can do this yourself.
7. Use the ‘Open in App’ option
   In Teams, click the file and select ‘Open in App’ instead of ‘Open in Teams’. This opens the file in the desktop application, such as Word or Excel, which may bypass the Teams-specific permissions check. If the file opens, the issue is with Teams’ file viewer, not the actual permission.

If Teams Still Shows Access Denied After the Main Fix

Sometimes the basic steps do not resolve the issue. The following scenarios cover additional causes and their fixes.

Teams File Shows Access Denied for a Guest User

Guest users have limited permissions by default. They can see the channel but may not be able to open files if the sharing link is restricted. Check the sharing link that was used to share the file. If it says ‘People in your organization’, change it to ‘People with the link’ or ‘Specific people’ and include the guest’s email. Also, ensure that the guest is added as a member of the SharePoint site, not just the Teams channel. Go to SharePoint > Site permissions > Invite people and add the guest.

Teams File Shows Access Denied After OneDrive Sync Update

A recent OneDrive update may have changed the sync behavior. Check the OneDrive version by right-clicking the cloud icon and selecting ‘Settings’ > ‘About’. If you have a version from 2023 or earlier, consider updating to the latest version. Alternatively, you can turn off the ‘Files On-Demand’ feature. Right-click the cloud icon, select ‘Settings’ > ‘Sync and backup’, and uncheck ‘Files On-Demand’. This forces OneDrive to download all files, which can eliminate permission conflicts.

Teams File Shows Access Denied Because of a Data Loss Prevention Policy

If your organization uses Data Loss Prevention policies, a file may be blocked because it contains sensitive information. The policy will show a warning in the file’s properties in SharePoint. Contact your IT admin to review the policy. They can exempt the file or adjust the policy to allow access.

Teams File Shows Access Denied on a Mobile Device

On mobile, the Teams app uses a different file viewer. If you get Access Denied only on your phone, the issue might be with the mobile app’s cache. Close the Teams app completely and reopen it. If that does not help, uninstall and reinstall the app. Also, ensure that your mobile device has enough storage space.

Teams Desktop vs Teams on the Web: Access Denied Differences

Item	Teams Desktop	Teams on the Web
File opening method	Uses local sync and desktop apps	Uses browser and SharePoint directly
Sync interference	OneDrive sync can cause locks	No sync interference
Permission check	Uses Teams and SharePoint permissions	Uses SharePoint permissions only
Cache issues	Local cache can become stale	Browser cache can be cleared easily
Best for troubleshooting	Good for offline access	Good for verifying actual permissions

Now you can resolve Access Denied errors by checking sync status, verifying permissions, and resetting the sync relationship. Start with ‘Open in SharePoint’ to confirm the file is accessible. Then adjust the sharing settings or stop and restart sync. If the issue persists, clear the cache or check for checked-out files. Use the web version of Teams to isolate the problem. For a permanent fix, consider disabling Files On-Demand if the problem recurs.