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.
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
Sign in using an account with one of the following roles:
Global Administrator
SharePoint Administrator
Open the Diagnostic Tool
Open the following URL in a web browser:
https://aka.ms/PillarSiteUserIDMismatch
Enter Required Information
In the diagnostic tool, provide:
User's Email Address or User Principal Name (UPN)
Affected SharePoint Site URL
Run the Diagnostic
Click Run Tests or Run Diagnostic.
Wait for the analysis to complete.
Review Recommendations
Review the results provided by the diagnostic tool.
Follow the recommended actions to resolve any detected Site User ID mismatch issues.
If required, revalidate user permissions and test access again.
Verification
After completing the diagnostic:
Ask the affected user to sign out and sign back in.
Attempt to access the shared file or folder again.
Confirm that the shared content opens successfully.
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.
