Teams search finds nothing or too little
You search for a message or person, Teams returns nothing or stale hits. Resetting the index cache is usually the fix.
Affected systems
Quick fixes
- Cross-check in the web client at https://teams.microsoft.com
- Clear cache so Teams rebuilds the index
- Check tenant - search only sees the current tenant
Why search fails
Teams keeps a local search index for your active tenant. If it is corrupt or lagging, hits are missing.
Common pitfalls:
- Searching in the wrong tenant - switch top right and retry
- Stale cache - reset helps
- Tenant boundary - cross-tenant search is limited
- Retention policy deleted old messages
Web client as baseline
Fastest diagnostic: same search in https://teams.microsoft.com in a private browser window. If hits appear there, the desktop cache is to blame. If web finds nothing either, the message is really gone.
Clear cache
%appdata%\Microsoft\Teams
~/Library/Application Support/Microsoft/Teams
~/Library/Group Containers/UBF8T346G9.com.microsoft.teams
%localappdata%\Packages\MSTeams_8wekyb3d8bbwe\LocalCacheAfter reset the first search takes longer - Teams rebuilds the local index. Within 5-10 minutes everything should be indexed.
Filter limits the scope
Above the search field you can pick a filter (People, Messages, Files). If you search in “People” but expect a message, you find nothing. Check the filter.
Use search operators
Teams supports simple operators:
from:Max- messages from Maxin:Channel-Name- only in a channelsubject:Project- channel post with subject
Useful when full-text returns too many hits.