User guide4 min

Connect Google Search Console

Connect a site to Google Search Console and PixyScan shows the clicks, impressions, CTR and average position Google reports for it, by page and by query, on the Search performance screen. It starts at Hobby, needs admin access to the site, and only ever reads from Search Console.

Before you start#

Check these four things first. Each one stops the connection if it is missing.

Tier: Hobby or above. Free shows a locked card with an upgrade link.
Your role: Admin access to the site. Viewers can see the connection but cannot change it.
Google account: One that is a verified user of the site's Search Console property.
Access asked for: Read-only. PixyScan never changes anything in Search Console.

Connect a site#

Each site connects on its own, so a client's site can use the client's Google account.

1
Open the Search Console tab
Open the site, choose Settings under Manage, then open the Search Console tab.
2
Choose a Google account and approve
Press Connect Google Search Console. Google asks you to pick an account and to let PixyScan view your Search Console data. Approve it, and Google sends you back to the same tab.
3
Pick the property
PixyScan lists every property the account can see. The one that best matches the site's address is labelled Best match for this site and is already selected. Each property shows whether it is a Domain or URL-prefix property, and your access level. Press Use this property.
4
Let the history load
PixyScan loads the most recent days first, then older months over the next few minutes, as far back as your tier keeps. After that it syncs once a day. Sync now fetches new days early, once every 15 minutes per site.

app.pixyscan.com/w/…/s/…/settings?tab=search-console

Screenshot · not captured yet

The Search Console tab of Site settings after connecting: the Google account, the chosen property, the sync status, the last sync time and the history kept on your tier, with Sync now, Change property and Disconnect.

Once connected, the tab shows which Google account and property the site reads, and when it last synced.

Read Search performance#

Search performance is in the Explore group of the site sidebar, between Performance and AI readiness.

Field	Shows	What it does
Search type	Web	Web, Image, Video, News, Discover or Google News. Discover and Google News have no query data, so they show pages only.
Date range	28 days	7, 28 or 90 days, 6 months or 16 months. Ranges longer than your tier keeps are disabled.
Totals	Four figures	Clicks, impressions, CTR and average position, each with its change against the period before.
Trend	Chart	Clicks and impressions day by day across the range.
Queries and Pages	Tables	Search, sort and page through either list. Open a row to see the pages for that query, or the queries for that page, and the split by device and by country. These come straight from Google when you open them.
Export	CSV	Downloads the Queries or Pages table you are looking at. A very long table is trimmed to its top rows.

Query rows leave out anonymised queries, which Google withholds for privacy, so they add up to less than the totals. The latest two to three days are provisional and can still change.

Search performance does not read a scan. The data belongs to the site and is synced from Google, so it stays the same whichever scan you have open.

History on each tier#

How far back PixyScan keeps a site's Search Console data.

Field	History kept	What it does
Free	—	Not included.
Hobby	90 days	The last 90 days.
Basic	6 months	The last 180 days.
Pro and Enterprise	16 months	Google's maximum. Google keeps nothing older.

Upgrading loads the older months on the next sync. Moving to a smaller paid tier hides the older days straight away and deletes them 30 days later.

Disconnect, downgrade or change of admin#

What happens to the connection, and to the data, in each case.

Disconnect. Press Disconnect on the Search Console tab and confirm. PixyScan stops syncing and deletes the site's synced Search Console data.

Moving to Free. Syncing pauses and the data is hidden. Upgrade within 30 days and it picks up where it stopped. After 30 days the data is deleted and the site has to be connected again.

The person who connected loses admin access. Syncing pauses until another admin reconnects with their own Google account. If nobody does within 30 days, the data is deleted.

Changing the property. Only the person who connected the site can choose a different property. Anyone else with admin access reconnects with their own Google account and picks one.

Your Google data stays read-only and private to the workspace

Only members who can open the site see its Search Console data. The access Google grants is stored encrypted. The Privacy Policy explains how Google user data is handled.

Troubleshooting#

The three problems people hit most often.

Google says the app has not been verified. Google shows this while its review of PixyScan's Search Console access is still in progress. It is about the review, not about your account. Choose Advanced, then continue to PixyScan. If Google does not let you continue, contact support.

The property is missing, or cannot be chosen. The list shows every property the Google account can see. A property marked Needs verified access in Search Console is one where the account is Unverified. Ask an owner of the property to add the account as a user in Search Console, then reconnect. If the property is not listed at all, the account has no access to it: connect a Google account that does.

Google access was removed. If access is removed in the Google account, or expires, the tab shows Google access was removed. Press Reconnect and approve again. If nobody reconnects within 30 days, the data already synced is deleted.

Does something here not match what you see in the app? Tell us