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

Error	Likely cause
User does not have sufficient permission	Service account not added to GSC property
Site not found	URL doesn't exactly match the verified property URL