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 diagnostics in the Microsoft 365 admin center to resolve common issues.
Note
These diagnostics aren't available for the GCC High or DoD environments, or for Microsoft 365 operated by 21Vianet.
Diagnostic capabilities for a few text queries were first released within the Microsoft 365 admin center support portal in December 2018.
Scenarios covered by diagnostics
Note
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 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 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 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 |
| 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 5 TB | 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 |
| 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 |
| Site User ID Mismatch | Detects ID mismatches for users on OneDrive or SharePoint sites and offers to fix the issue. | Run Tests: Site User ID Mismatch | Fix site user ID mismatch in SharePoint or OneDrive |
Note
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.