Integrations Updated
Connect Google Search Console
Connect your Search Console site to Prism with read-only access, check its status and fix connection errors.
4 min read Updated
What is it?
Google Search Console is a free Google tool. It shows how your site performs in Google search. Prism uses it for clicks, impressions, CTR (clicks divided by impressions) and average position (where your page appears in results).
Why use it?
Search Console data powers the search side of Prism: the Analytics (GA4 + GSC) screen, Advanced Analytics reports such as Keywords Breakdown, and the GSC · Top queries panel on the Unified Dashboard.
Before you start
- You need a Google account that can view the site in Google Search Console.
- Select the right project in the Current Project switcher. The connection belongs to that project.
How to use it
Open Integrations
In the left sidebar, under System, click Integrations & MCP. You can also click Property settings on the Analytics screen.
Start the connection
On the Google Search Console card, click Connect Google Search Console. The button shows Redirecting… and Google opens.
Sign in and allow access
Choose your Google account. Allow Prism to view your Search Console data.
Pick your site
Prism shows Verifying your Google account…, then Signed in as with your email and Choose the site to connect to this project. Each site shows your permission level. Click a site, then click Connect site.
Finish
You see Finishing setup…, then Google Search Console connected and Redirecting you back to Prism….
Understanding the screen
Card status
| Status | What it means |
|---|---|
| ● Connected | Prism can read your data. The card shows your site and "synced through" with a date. |
| + Available | Not connected yet. Click the connect button. |
| ⚠ Needs attention | The last sync failed, or Google access was removed or expired. The card shows the error. See Reconnect or disconnect. |
| … Checking | Prism is checking the connection. |
| ⚠ Can't reach server | Your browser could not reach Prism to check the status. Refresh the page. |
A connected card has a Disconnect button. A card that needs attention has Reauthenticate and Disconnect. Use Search integrations… at the top to find a card.
On the Analytics (GA4 + GSC) screen, the Google Search Console card shows Not connected, Connected or Needs attention, plus Last synced with a date or No syncs yet.
Changing the site
To use a different site for this project, start the connection again and pick the new site. Prism loads up to 180 days of history for it. If you pick the same site again, your history stays and Prism checks the connection right away.
Understanding the data
- The first time you connect, Prism loads up to 180 days of history.
- After that, it syncs every day.
- Data runs through two days ago. Report ranges end three days before today.
Full details: Data sync schedule.
Some searches are hidden by Google for privacy. Prism shows them as a (not set) row so totals match Search Console. See (not set) explained.
Tips
- Connect Google Analytics 4 too, so you can see sessions and conversions next to clicks.
- If you have several sites, connect the one that matches this project.
Common issues
Errors during the Google steps appear under the heading Connection failed. Click Back to Integrations and try again.
| Message | How to fix it |
|---|---|
| No Search Console sites were found for this Google account. | Sign in with a Google account that has access to the site. |
| You declined access to your Google Search Console data. | Start again and click allow on the Google screen. |
| Search Console access was not granted. Please accept the webmasters.readonly permission to connect. | Start again and keep the permission ticked. |
| Missing authorization code from Google. Please try connecting again. | Start the connection again. |
| Invalid or expired state | The connection took too long or was interrupted. Start again. |
| Google returned an error: (code) | Google sent back an error. Start again. If it repeats, contact support. |
| Failed to complete Search Console connection | Try again later or contact support. |
| Failed to save selected Search Console site | Try again. If it keeps failing, contact support. |
| Failed to start Google Search Console connection | Shown on the Integrations screen. Refresh the page and try again. |
More help: Connection issues.
Frequently asked questions
Which Google account should I use?
Use a Google account that can see the website in Google Search Console. The site picker shows your permission level for each site.
Why does it say No Search Console sites were found for this Google account?
The Google account you chose has no Search Console sites. Start again and sign in with an account that has access.
Can Prism change my Search Console settings?
No. Prism only asks for the webmasters.readonly permission, which lets it read your data and nothing else.
Can I switch the project to a different Search Console site?
Yes. Connect again and pick the other site. Prism then loads up to 180 days of history for the new site.
Related articles
- IntegrationsConnect Google Analytics 4Connect your GA4 property to Prism with read-only access so you can see sessions, conversions and revenue next to your search data.Read
- IntegrationsData Sync ScheduleWhen Prism syncs Search Console and GA4, how far back the first load goes, why the newest days lag, and how rank and LLM data refresh.Read
- IntegrationsReconnect or DisconnectFix a connection that says Needs attention by reauthenticating, or disconnect Search Console or GA4 from a project.Read
- TroubleshootingConnection IssuesFix Google Search Console and GA4 connection errors, Needs attention cards, Can't reach server, disconnects and buttons that do nothing yet.Read
Was this article helpful?
Still stuck? Try troubleshooting or email support.