> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heypharos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Search Console to compare AI and search rankings

> Link your Search Console property to see keyword impressions, clicks, and average position alongside your Pharos AI visibility scores in a single view.

Connecting Google Search Console gives Pharos access to your organic search performance data: which queries drive impressions and clicks to your site, which pages rank for those queries, and where your average position sits. Viewed alongside Pharos's AI visibility scores, this lets you compare how your brand performs in traditional search versus AI platforms — and identify content gaps that affect both channels simultaneously.

## Before you connect

You need **Owner** or **Full user** permission on the Search Console property you want to connect. Restricted users cannot grant the OAuth scopes Pharos requires. If you are unsure of your permission level, check **Settings → Users and permissions** in Search Console.

## Connect Search Console

<Steps>
  <Step title="Open Integrations settings">
    In the sidebar, navigate to **Settings**, then click the **Integrations** tab.
  </Step>

  <Step title="Find Google Search Console">
    Under the **Measure & Attribute** section, locate the **Google Search Console** card. The subtitle shows **Branded search impressions & clicks** when not yet connected.
  </Step>

  <Step title="Click Connect">
    Click the **Connect** button. A Google OAuth popup opens.
  </Step>

  <Step title="Sign in and grant access">
    Sign in to the Google account that has access to your Search Console property, then click **Allow** to grant Pharos read access.
  </Step>

  <Step title="Select your property">
    After the popup closes, a property selector dialog appears listing all Search Console properties accessible to your Google account. Choose the property that matches your brand's domain and click **Select**.
  </Step>
</Steps>

<Note>
  If your browser blocks the popup, Pharos falls back to a full-page redirect. After you complete the Google sign-in and return, Pharos picks up the authorization code automatically and opens the property selector. Allow popups for Pharos to avoid this fallback.
</Note>

Once connected, the Search Console card displays your selected property URL and a green status indicator.

<Tip>
  If the property selector shows no properties, the Google account you signed in with does not have any Search Console properties with **Full user** access or higher. Sign in with a different account or add your account as a Full user in Search Console, then reconnect.
</Tip>

## Data Pharos pulls from Search Console

Pharos syncs Search Console data daily and aggregates it for display. You can view up to 28 days of history by default.

| Metric           | Description                                                            |
| ---------------- | ---------------------------------------------------------------------- |
| Impressions      | How many times a page from your site appeared in Google search results |
| Clicks           | How many times a user clicked through to your site                     |
| CTR              | Click-through rate: clicks divided by impressions                      |
| Average position | Impression-weighted average ranking position across all queries        |

Data is broken down across two dimensions:

* **By query** — the top 20 search queries by clicks, with impressions, CTR, and position for each
* **By page** — the top 10 pages by impressions, showing which URLs attract the most search visibility

Pharos also charts a **daily trend** of clicks and impressions over the selected period, so you can see how organic search volume changes over time and correlate it with Pharos AI visibility score movements.

<Info>
  Average position is calculated as an impression-weighted average, which matches how Google Search Console itself reports average position. Queries that appear on multiple pages are aggregated across all those pages.
</Info>

## Change your selected property

<Steps>
  <Step title="Open the connection panel">
    Go to **Settings → Integrations** and click the **Google Search Console** card. Clicking an already-connected card opens the connection details panel.
  </Step>

  <Step title="Click Change property">
    Click **Change property**. Pharos fetches your available properties and opens the selector.
  </Step>

  <Step title="Select the correct property">
    Choose a different property and click **Select**. Pharos starts pulling data for the new property immediately.
  </Step>
</Steps>

## Disconnect Search Console

Disconnecting stops Pharos from syncing new Search Console data. Previously synced data is retained.

<Steps>
  <Step title="Open the connection panel">
    Go to **Settings → Integrations** and click the **Google Search Console** card.
  </Step>

  <Step title="Click Disconnect">
    Click **Disconnect** and confirm the action in the prompt.
  </Step>
</Steps>

<Warning>
  Disconnecting removes the OAuth tokens Pharos holds for this property. You will need to complete the full OAuth flow again if you reconnect later.
</Warning>

After disconnecting, the Search Console card returns to its unconnected state and the **Connect** button becomes available again.