Unable to Access Shared File (Site User ID Mismatch Diagnostic)

This article explains how to diagnose and resolve shared file access issues caused by a Site User ID mismatch in SharePoint Online. Microsoft provides a dedicated diagnostic tool to identify and remediate user ID mapping issues that may prevent users from accessing shared content.

By Shivam VishwakarmaUpdated Oct 21, 2026

Applies To 

  • Microsoft 365 

  • SharePoint Online 

  • OneDrive for Business 

  • Shared file and folder access issues 

Symptoms 

  • User cannot access a shared file or folder. 

  • "Access Denied" or permission-related errors are displayed. 

  • Shared content works for some users but not others. 

  • Permissions appear correct, but the user is still unable to access the content. 

Cause 

The issue can occur when the user's SharePoint Site User ID does not match the account associated with the site's permissions. This may happen due to account changes, synchronization issues, or identity mismatches within SharePoint Online. 

Resolution 

Follow these steps to run the Site User ID Mismatch Diagnostic: 

Sign in to Microsoft 365 Admin Center 

  1. Sign in using an account with one of the following roles:  

  • Global Administrator 

  • SharePoint Administrator 

Open the Diagnostic Tool 

  1. Open the following URL in a web browser: 

https://aka.ms/PillarSiteUserIDMismatch 

Enter Required Information 

  1. In the diagnostic tool, provide:  

  • User's Email Address or User Principal Name (UPN) 

  • Affected SharePoint Site URL 

Run the Diagnostic 

  1. Click Run Tests or Run Diagnostic. 

  1. Wait for the analysis to complete. 

Review Recommendations 

  1. Review the results provided by the diagnostic tool. 

  1. Follow the recommended actions to resolve any detected Site User ID mismatch issues. 

  1. If required, revalidate user permissions and test access again. 

Verification 

After completing the diagnostic: 

  1. Ask the affected user to sign out and sign back in. 

  1. Attempt to access the shared file or folder again. 

  1. Confirm that the shared content opens successfully. 

  1. Verify that no permission or access errors are displayed. 

Troubleshooting 

Issue: Diagnostic tool does not detect any problems. 
Resolution: Verify that the correct user account and SharePoint site URL were entered. 

Issue: User still cannot access the shared file after remediation. 
Resolution: Review site, library, and file-level permissions and ensure the user has appropriate access. 

Issue: Multiple accounts exist for the same user. 
Resolution: Confirm the user is signing in with the account that has been granted access to the SharePoint site. 

Issue: Access issue persists after applying recommendations. 
Resolution: Re-run the diagnostic and review SharePoint audit logs and user permissions for additional troubleshooting. 

 

Was this article helpful?