Self-help diagnostics for SharePoint Online and OneDrive administrators


It's important that administrators can diagnose and resolve issues quickly in SharePoint Online and OneDrive. To support this effort, the SharePoint support team has released features in the Microsoft 365 admin center to resolve common issues.


This feature is not available for Microsoft 365 Government, Microsoft 365 operated by 21Vianet, or Microsoft 365 Germany.

More information

Diagnostic capabilities for a few text queries were first released within the Microsoft 365 admin center support portal in December 2018.

Screenshot of the Run diagnostics page in the Microsoft 365 admin center.

When IT admins run customer diagnostics in the Microsoft 365 admin center to resolve issues without logging support requests, Microsoft will make donations to global nonprofit organizations.

For more information, see Diagnostics for Social Good

What scenarios are currently covered?


You must be a Microsoft 365 administrator to run diagnostics.

There are currently diagnostics covering various areas within SharePoint and OneDrive. Each diagnostic is listed below together with a brief description of its function, and a shortcut link:

Diagnostic Description Shortcut Link Support Article
OneDrive provisioning Diagnose issues that may occur during the provisioning of a OneDrive site collection. Run Tests: OneDrive Provisioning OneDrive for Business stopped at "Setting up..."
Site and page performance Diagnose why a site or page may be loading slowly. Run Tests: Site and Page Performance Diagnosing performance issues with SharePoint Online
SharePoint picture synchronization Diagnose why a picture may not be showing up in the user’s profile or via the People Web Part. Run Tests: Picture Sync Profile picture not showing in SharePoint Online
OneDrive storage quota Diagnose issues that may occur during a quota change for a OneDrive for Business site. Run Tests: OneDrive Storage Quota Change a specific user's OneDrive storage space
Site collection deletion Diagnose issues that may occur during the deletion of a site. Run Tests: Site Deletion Unable to delete a sharepoint site
Modernization Evaluates whether a view can be rendered in Modern mode. Run Tests: Modernization
Unable to synchronize OneDrive with a sync client Validates that the OneDrive library can be synchronized via the sync client. Run Tests: OneDrive Sync
Unable to synchronize a SharePoint Document Library with sync client Validates that the SharePoint document library is configured properly to allow synchronization of files. Run Tests: Library Sync
Access Denied due to organizational policies Unlocks administrators who are locked out of SharePoint and OneDrive because of a location-based policy. Run Tests: Access Denied due to org policy Access Denied due to organizational policies
Invalid retention or grace eDiscovery hold Detects and removes an invalid retention or grace eDiscovery hold blocking an administrator from deleting a site. Run Tests: Invalid Retention Hold A compliance policy is currently blocking this site deletion
OneDrive web access issue Detects and renames the OneDrive default document library back to 'Documents' Run Tests: OneDrive Library Path Error - This item might not exist
OneDrive Storage limited to 5 TB Verifies that a user’s OneDrive site storage is eligible for increased storage capacity beyond 5 TB Run Tests: OneDrive Storage Limited to 5TB Check OneDrive site storage eligibility for storage beyond 5 TB
SharePoint Tenant Storage Verifies any issues with your SharePoint Online tenant storage quota displayed in SharePoint admin center and shows how quota is allocated Run Tests: Tenant Storage SharePoint Online out of storage space
Check User Access Validates that the internal/external user has access to the site and checks for known issues that can prevent access. Run Tests: Check User Access Permission errors when accessing SharePoint or OneDrive
OneDrive Site Access Validates that the user's OneDrive site exists, and there are no known issues accessing the site. Run Tests: OneDrive Site Access
Locked Site Validates that the user's OneDrive or SharePoint site exists, and there are no known issues accessing the site due to lock or archived state. Run Tests: Locked Site SharePoint or OneDrive read-only error messages


If a diagnostic detects an issue, and you've implemented a fix based on the results, consider rerunning the diagnostic to ensure the issue is completely resolved.

Still need help? Go to Microsoft Community.