Skip to content

Google Search Console Integration ​

Connecting Google Search Console shows organic search performance — queries, impressions, clicks, and average position — in the client's portal.

Prerequisites ​

  • A verified Google Search Console property for the client's website
  • A Google service account with access to the property

Connecting for a client ​

  1. Open the client in /admin/clients.
  2. Go to Integrations → Google Search Console.
  3. Enter the site URL exactly as it appears in Search Console (e.g. https://example.com/ — note the trailing slash).
  4. Upload or paste the service account credentials JSON.
  5. Click Test Connection.
  6. Click Save.

Service account setup ​

Use the same service account you created for GA4 (or create a new one):

  1. In Google Search Console, go to Settings → Users and permissions.
  2. Add the service account email with Full or Restricted access.

What the client sees ​

The client's dashboard shows top queries, total clicks, impressions, and average position for their website over a rolling date range.

Troubleshooting ​

ErrorLikely cause
User does not have sufficient permissionService account not added to GSC property
Site not foundURL doesn't exactly match the verified property URL

Client Portal Help Documentation