Search Analytics Troubleshooting
Track what users search for in your docs. Identify content gaps from failed searches and improve discoverability.
Search analytics show what readers look for and where content gaps exist.
Accessing Search Analytics
- Go to your project's Analytics
- Select the Search tab
Search Metrics
Top Searches
The most common search queries in your docs:
| Query | Searches | Click rate |
|---|---|---|
| authentication | 145 | 78% |
| api key | 89 | 92% |
| rate limits | 67 | 65% |
Failed Searches
Queries that returned no results—these are documentation gaps:
| Query | Searches | Action needed |
|---|---|---|
| pricing | 34 | Add pricing page |
| webhooks | 28 | Create webhooks docs |
Review failed searches weekly. They tell you exactly what documentation your users need but can't find.
Using Search Data
Identify Content Gaps
High-volume failed searches indicate missing content:
- Export failed searches
- Group by topic
- Prioritize by search volume
- Create the missing documentation
Improve Existing Content
If searches have low click rates:
- The title may not match what users expect
- The content may not answer the query
- Consider adding keywords to improve matching
Optimize Navigation
Popular searches might deserve:
- A spot in main navigation
- A dedicated landing page
- Links from related pages
Search Quality Score
Jamdesk calculates a search quality score:
Score = (Searches with clicks / Total searches) × 100| Score | Rating |
|---|---|
| 90%+ | Excellent |
| 70–89% | Good |
| 50–69% | Needs improvement |
| Below 50% | Poor |
Data Export
Export search data for further analysis:
- Go to Analytics → Search
- Click Export
- Choose CSV or JSON format