Copy as markdown[View .md](https://docs.funnelfizz.com/concepts/seo "View the raw markdown for this page")[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fconcepts%2Fseo.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20SEO "Open this page in Claude with context")[Open in ChatGPT](https://chat.openai.com/?q=Read%20https%3A%2F%2Fdocs.funnelfizz.com%2Fconcepts%2Fseo.md%20and%20help%20me%20with%20this%20FunnelFizz%20topic%3A%20SEO "Open this page in ChatGPT with context")

# SEO

The SEO dashboard surfaces Google Search Console data alongside your funnel stages — impressions and clicks at AWARENESS, query/page breakdowns in the widget, country and device cuts. Connected workspaces see real data; demo funnels render deterministic mock data so the dashboard is always non-empty.

## How to connect[​](#how-to-connect "Direct link to How to connect")

1. Open **Settings → Integrations** and connect Google Search Console via OAuth.
2. If your GSC account has multiple verified properties, pick which one this workspace's funnel reports against in **Settings → SEO** (a property switcher appears).
3. Wait for the next sync tick — first impressions land within \~15 minutes.

## What you get[​](#what-you-get "Direct link to What you get")

Per-funnel widget:

* Impressions, clicks, CTR, average position over the selected time window.
* Top 15 queries by impression (with click + position columns).
* Top 15 landing pages.
* Country breakdown and device breakdown.

AWARENESS aggregate counts roll the same impression numbers into the funnel-level conversion math, so SEO traffic shows up next to your other AWARENESS sources.

## Demo funnels[​](#demo-funnels "Direct link to Demo funnels")

Demo funnels (the example workspace each new account gets seeded with) render synthetic SEO data exclusively. Real visitor activity never lands on them — see the [Demo funnel architecture](https://docs.funnelfizz.com/concepts/users.md#what-lands-on-the-activity-timeline) note.

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

If the widget says "No data" after connecting:

* GSC takes 24–48 hours after first indexing a property to surface query data. Brand-new properties may need to wait.
* The sync runs hourly. If you just connected, the first tick may not have run yet.
* If your GSC token expires (`integrations.gsc.refresh-failed` in operator logs), reconnect via Settings → Integrations.

For deeper inspection, [search.google.com/search-console](https://search.google.com/search-console) remains the authoritative source.
