sharepoint

SharePoint Search Not Working

Resolution Checklist

  • 1 Understand search crawler delays and visibility settings
  • 2 Verify site-level search settings and index visibility
  • 3 Request manual re-indexing of sites or libraries
  • 4 Query Search API to isolate crawler vs client issues
  • 5 Clear local client search caches and reload settings

SharePoint Search Not Working

This article provides a diagnostic checklist and troubleshooting guide to resolve SharePoint Search Not Working (such as new files not showing in search results, search refiners not updating, or local OneDrive search failing to locate synced files).

Root Causes / Meaning

SharePoint Search uses a continuous crawler to discover new content and populate the search index. When search fails, it is usually due to:

  1. Search Visibility Disabled: The site, list, or library settings have search visibility disabled, which prevents the crawler from indexing any items within them.
  2. Continuous Crawl Latency: SharePoint Online usually indexes files within a few minutes, but heavy tenant load can delay crawl cycles for up to 24 hours.
  3. Draft Item Security: If the library restricts draft items to only users who can edit them, search results will exclude those files for read-only users.
  4. Managed Property Schema Mappings: Custom columns will not be searchable or filterable unless they are mapped to Searchable/Refinable Managed Properties.
  5. Local Indexer Issues: On local desktop environments, OneDrive’s Search Integration database or the operating system’s local search indexer (Windows Search or macOS Spotlight) is out of sync.

Initial Checklist

Before proceeding to advanced fixes, perform these basic checks:

  1. Check Web Search: Verify if the missing file can be found by searching directly in the SharePoint Online web interface. If it is visible online but not locally, the issue is with the local index.
  2. Verify Permissions: Ensure the affected user has at least Read permissions to the file. Search results are security-trimmed.
  3. Wait for Crawl: If the file was uploaded in the last 15–30 minutes, wait to allow the continuous crawler to process the changes.

Platform-Specific Resolving Steps

Windows Users

Step 1: Force Re-index of a Library (SharePoint Online)

If SharePoint Online is not showing search results, trigger a manual crawl:

  1. Open the SharePoint document library in your browser.
  2. Click Settings (gear icon) > Library settings > More library settings.
  3. Under General Settings, click Advanced settings.
  4. Scroll down to Reindex Document Library and click the Reindex Document Library button.

Step 2: Restart and Reset Windows Search Indexer

If local search in OneDrive folders fails:

  1. Open Command Prompt as Administrator.
  2. Restart the Windows Search service to clear temporary locks.
  3. If issues persist, rebuild the search index using the command below.
:: Stop and restart the Windows Search service
net stop wsearch
net start wsearch

:: Rebuild local OneDrive search files database (OneDrive reset)
taskkill /f /im OneDrive.exe
"%localappdata%\Microsoft\OneDrive\onedrive.exe" /reset

macOS Users

Step 1: Force Re-index of SharePoint Libraries

Perform the same web-based Re-index steps as above.

Step 2: Fix macOS Spotlight Indexing for OneDrive Synced Files

macOS Spotlight indexes Files-On-Demand. If search inside the Finder OneDrive sync folder is broken, force Spotlight to re-index the directory:

  1. Open terminal.
  2. Add the OneDrive folder to Spotlight’s exclude list, then remove it to force re-indexing:
# Add the synced directory to the Spotlight indexing exclusion list
sudo mdutil -i off /Users/$USER/Library/CloudStorage

# Turn Spotlight indexing back on for the directory to trigger a full rebuild
sudo mdutil -E -i on /Users/$USER/Library/CloudStorage

Actionable Command Blocks

Diagnose Search via SharePoint REST API (cURL / macOS & Windows Terminal)

Verify if the issue is a crawler delay or a UI display bug. Run a search query against the SharePoint REST API to see if the search index contains the file. Replace <tenant> and <query> with your details:

# Request search results directly from the SharePoint REST API
curl -X GET -H "Accept: application/json;odata=verbose" \
"https://yourtenant.sharepoint.com/_api/search/query?querytext='YourFileName'"

PowerShell (Windows) - Request Re-indexing of Site via SPO Management Shell

Admin-level scripting to force a site-wide crawl:

# Install SPO Management Shell if not already present
# Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

# Connect to SPO Admin Service
Connect-SPOService -Url "https://yourtenant-admin.sharepoint.com"

# Request re-indexing of a target site collection
$SiteUrl = "https://yourtenant.sharepoint.com/sites/Marketing"
$Site = Get-SPOSite -Identity $SiteUrl
$Site.RequestReindexing()

Summary Checklist

  • Checked search results in the SharePoint web interface.
  • Confirmed that Allow items from this site/library to appear in search results is set to Yes.
  • Verified that Draft Item Security in library settings is not blocking the user.
  • Triggered a Reindex Document Library in Advanced settings.
  • Restarted/rebuilt the local search indexer (Windows Search or macOS Spotlight).