SearchPerformancePane
The Performance pane shows real-time search metrics inside the Sanity document editor for each matched page.
Overview
When you open a document that has been matched to a GSC URL, the Performance tab displays a dashboard with:
- 28-day summary metrics — total clicks, total impressions, average CTR, and average position
- Trend indicators — whether each metric is trending up or down compared to the previous period
- Weekly breakdown chart — a bar chart showing clicks and impressions per week
- Top 5 queries — the highest-traffic search queries driving visits to this page, with position, impressions, and click counts
- Index status badge — shows whether Google has indexed the page, with coverage state and last crawl time
- Last updated timestamp — when the snapshot was last synced
How it works
The pane reads from gscSnapshot documents in Sanity. Each snapshot is linked to both a GSC site and a Sanity content document via the linkedDocument reference field.
Snapshots are written by the SyncEngine during each sync. They aggregate metrics for three time periods: last 7 days, last 28 days, and last 90 days. The pane currently displays the 28-day view.
Weekly breakdown
The weekly breakdown splits the 28-day period into individual weeks and shows a stacked bar for clicks and impressions. This helps editors spot trends at a glance — a declining bar pattern signals that a page is losing traffic and may need a refresh.
Top queries
The top 5 queries section shows the actual search terms people use to find this page. Each query displays:
- Query text — the search term
- Impressions — how often the page appeared for this query
- Clicks — how often users clicked through
- Average position — ranking position for this query
This data is invaluable for understanding search intent and optimizing content accordingly.
Index status
If index status has been checked (via --check-index during sync), a badge shows the current indexing state:
- Indexed — the page is in Google's index and eligible to appear in search results
- Not indexed — the page was found but excluded from the index, with a reason from Google
- Last crawl time — when Googlebot last visited the page
When no data is shown
The pane distinguishes two empty states:
- Configured but no data — "Awaiting search data — This page hasn't appeared in Google Search Console data yet." This means the document type is tracked by a GSC Site but no search impressions have been recorded. Data will appear after a sync once the page starts getting search traffic.
- Not configured — "No GSC Site is configured to track documents of type 'X'." This means no URL configuration in your PageBridge GSC Site settings matches this document type. Add a URL configuration in your GSC Site settings to start tracking it.
If a page is configured but still shows no data after syncing, use pagebridge diagnose to troubleshoot URL matching issues.