Jamdesk Documentation logo

Search Analytics

See what readers search for in your documentation and find queries that return no results.

See what readers search for, which queries return no results, and what they click.

For page views and visitor data, see Project Analytics.

If search data is missing or delayed, see Analytics Issues.

Viewing Search Analytics

1
Open your project

Go to dashboard.jamdesk.com and select your project.

2
Click Search Analytics

In the sidebar under Analytics, click Search.

3
Select a date range

Pick a period with the date picker. The default is 30 days.

Key Metrics

MetricDescription
Total SearchesNumber of searches performed in the selected period
Unique QueriesDistinct search terms used
Zero ResultsSearches that returned no matches
Click-through RatePercentage of searches with a clicked result

Each metric shows the percentage change from the previous period.

Example snapshot:

{
  "period": "Last 30 days",
  "total_searches": 940,
  "unique_queries": 312,
  "zero_results": 42,
  "top_queries": [
    { "query": "authentication", "searches": 84, "ctr": 0.82 },
    { "query": "api keys", "searches": 63, "ctr": 0.71 }
  ]
}

Search Volume

The search volume chart shows daily searches over the selected period. Use it to:

  • Spot weekday and weekend patterns
  • Spot spikes from external links or announcements
  • Track growth over time

Query Breakdown

Top Searches

The most common search terms show:

  • Popular topics: what readers need most often
  • Navigation issues: searches for pages already in the navigation
  • Terminology gaps: terms that differ from the ones in your docs

Each query shows:

  • Number of searches
  • Number of clicks on results
  • Click-through rate (CTR)

Content Gaps

Content gaps are searches that returned zero results. Each one is a topic your docs do not cover yet.

The Content Gaps tab lists queries that found nothing. Common causes:

CauseSolution
Missing documentationCreate a new page covering the topic
Different terminologyAdd synonyms or update headings
Typos in contentFix spelling in your docs
Feature not yet documentedAdd to your documentation roadmap

Search Insights

InsightWhat It Means
Avg. Click PositionAverage position of the clicked result (lower is better)
Searches per DayAverage daily search volume
Top QueryYour most common search term
Most MissedThe top zero-result query to address

Best Practices

Set a recurring task to review zero-result searches.

Readers search with natural phrases. Write headings that match them.

If readers search for "setup" but your page is called "installation", mention "setup" in the page.

Watch click-through rates after you fix content gaps. Low CTR on high-volume queries means results don't match what readers want.

Search Quality Score

Jamdesk calculates a search quality score based on click-through rate:

Score = (Searches with clicks / Total searches) × 100
ScoreRating
90%+Excellent
70-89%Good
50-69%Needs improvement
Below 50%Poor

Data Export

  1. Go to Analytics → Search
  2. Click Export
  3. Choose CSV or JSON format

Data Availability

Search data appears after the daily rollup at 2 AM UTC. Today's searches appear tomorrow.

New sites need 24-48 hours of search data before the numbers mean much.

What's Next?

Analytics Overview

Understand project vs search analytics

Project Analytics

Track visitors, page views, and traffic sources

Analytics Issues

Troubleshoot missing or delayed data

MDX Basics

Improve content discoverability