How to Fix SharePoint Error Correlation ID Errors
Diagnostic Procedures
- 1 Understand SharePoint Correlation IDs
- 2 How to Locate the Root Cause using the Correlation ID
- 3 Query ULS Logs on SharePoint On-Premises
- 4 Investigate Correlation IDs in SharePoint Online
- 5 Restarting SharePoint IIS and Timer Services
How to Fix SharePoint Error Correlation ID Errors
A Correlation ID in SharePoint is a globally unique identifier (GUID) automatically assigned to every web request received by the server. When an error occurs, SharePoint displays the Correlation ID along with a timestamp. This ID is not an error code itself; instead, it is a lookup key that allows administrators to find the exact database, code, or service failure in the server logs.
This guide explains how to capture Correlation IDs, trace them through ULS logs, and resolve underlying server issues.
Understand SharePoint Correlation IDs
When SharePoint displays a correlation error, it typically points to:
- Database Timeouts or Connection Failures: SQL Server is unresponsive or the query took too long.
- Custom Web Part Exceptions: Broken third-party scripts, custom sandboxed solutions, or outdated web parts.
- Permission Blocks: A security policy blocked a service account from executing a background query.
- Timer Service Failures: Background jobs failing to process.
How to Locate the Root Cause using the Correlation ID
To fix the error, you must use the Correlation ID to find the underlying error log entry.
Step 1: Capture the Metadata
Write down or copy the exact details shown on the error screen. You will need:
- Correlation ID: e.g.,
8afb3a9e-c011-80fc-1234-5678abcdef01 - Date and Time: The precise timestamp (in UTC or local server time).
Step 2: Query ULS Logs on SharePoint On-Premises
If you host your own SharePoint Server farm (SharePoint 2013, 2016, or 2019/SE), search the Unified Logging Service (ULS) logs.
Using PowerShell:
Open the SharePoint Management Shell as Administrator on one of your Web Front End (WFE) servers and run:
# Merge logs from all servers for a specific Correlation ID
Merge-SPLogFile -Path "C:\Logs\CorrelationSearch.log" -Correlation "8afb3a9e-c011-80fc-1234-5678abcdef01"
# Alternatively, view the error details directly in the console
Get-SPLogEvent -StartTime (Get-Date).AddMinutes(-30) | Where-Object {$_.Correlation -eq "8afb3a9e-c011-80fc-1234-5678abcdef01"} | Format-List Area, Category, EventID, Message
Using ULS Viewer:
- Download and run the Microsoft ULS Viewer tool on the server.
- Open the active log file located by default at:
C:\Program Files\Common Files\microsoft shared\Web Server Extensions\16\LOGS - Press
Ctrl + F, choose Correlation, paste the GUID, and click Find Next. - Read the Critical or Unexpected messages associated with that GUID.
Step 3: Investigate Correlation IDs in SharePoint Online
For SharePoint Online (Microsoft 365), you do not have direct access to ULS logs. Follow these steps:
- Open the Microsoft 365 Admin Center (
admin.microsoft.com). - Search the Service Health Dashboard to check if there is an active outage matching the timestamp.
- If no outage is active, navigate to the M365 Purview Compliance Portal > Audit.
- Search for SharePoint file or site activities matching the user and timestamp to identify permission conflicts.
- If the issue persists, open a Microsoft Support Ticket and provide the Correlation ID, the URL, and the Timestamp.
Step 4: Restarting SharePoint IIS and Timer Services (On-Premises Only)
If the logs show that the SharePoint Timer Service is hung or that IIS application pools are failing to respond, run these commands to reset the environment.
On the SharePoint Server:
- Open Command Prompt as Administrator.
- Execute the following commands to recycle IIS and restart the Timer Service:
:: Reset IIS Web Server
iisreset /noforce
:: Restart the SharePoint Timer Service
net stop SPTimerV4
net start SPTimerV4
:: Restart the SharePoint Administration Service
net stop SPAdminV4
net start SPAdminV4
Summary Checklist
- Copy the Correlation ID and the exact timestamp from the error page.
- For on-premises farms, run
Merge-SPLogFilein PowerShell to extract the logs. - Open the merged log file and look for “Unexpected” or “Critical” error levels.
- For SharePoint Online, verify the tenant’s Service Health status.
- If service restarts are needed on-premises, recycle IIS and restart the
SPTimerV4service.