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

# Google Search Console

> Connect Search Console so Narrative reads real impressions, clicks and ranking position for every page and query on your site

Google Search Console is the trusted source for where your site already ranks
and what people searched to find it. With it connected, Narrative reads
clicks, impressions and average position for every page and query, daily,
and uses them across the SEO module: to tell what is working from what is not,
to ground campaign recommendations in real demand, and to measure the pages
it publishes against the searches they were written for.

## Before you start

* You need a Google account that is an **owner or user** of the Search
  Console property for your site (full or restricted is fine; the connector
  reads only).
* Prefer a **domain property** (`example.com`) over a URL-prefix property
  (`https://www.example.com/`). A domain property covers every subdomain and
  protocol, so nothing Narrative crawls is missing from the numbers.
* Allow pop-ups for `app.yournarrative.ai`. Google's consent screen opens in a
  small window.

## Connect

**1. Open Connectors**

Go to **Personalize → Connectors** and click **Connect** on the Google
Search Console card. The card reads *Waiting for authorization* until
you finish in Google.

![The Connectors page with the Google Search Console card showing Waiting for authorization.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/gsc-waiting-for-authorization.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=e0a1f42c4e22fddd6cbb22a713fe8c21)

**2. Choose your Google account**

Pick the account that has access to the Search Console property.

![Google's Choose an account screen to continue to Narrative.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/google-choose-account.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=38730f30562c115ecd15e28f36657e57)

**3. Confirm it is you**

If you have connected a Google product before, Google confirms you are
signing back in. Click **Continue**.

![Google confirming that you are signing back in to Narrative.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/google-signing-back-in.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=17c396e350f0592a17a151bf56668aa3)

**4. Grant read-only access**

Google lists the one permission Narrative asks for: **View Search
Console data for your verified sites**. Tick it and click **Continue**.

![Google's permissions screen listing read-only access to Search Console data.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/google-permissions.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=c9893b984282aaa2010e4994666c8aa7)

**5. Pick the site**

Back in Narrative, the card reads **Finish setup**. Click it, pick the
Search Console property to read, and click **Connect**. Domain
properties are listed as `sc-domain:example.com`.

![The Connectors page with the Google Search Console card showing Finish setup after Google access was granted.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/gsc-finish-setup.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=3afeea0465cedd6b37a844d0deeab14f)

![Narrative's Choose what to connect dialog for Search Console.](https://mintcdn.com/narrative-22c775b1/2qy9Q7JF03n1vhXt/images/connectors/resource-picker-empty.png?fit=max\&auto=format\&n=2qy9Q7JF03n1vhXt\&q=85\&s=9a3093a952165c052050fb1a6151f458)

The picker lists every property the Google account can see. This account has none, which is the message to expect if you signed in with the wrong account.

**6. Wait for the first import**

The card turns **Connected**. Narrative imports the last six months of
daily search data by page and query, then tops it up every day. Search
Console publishes data with a delay of two to three days, so the most
recent days always fill in later.

## If the picker is empty

*We did not find anything on this Google account for Google Search Console*
means the account you chose is not an owner or user of any Search Console
property. Click **Cancel**, then **Finish setup** again with a different
account, or have a property owner add the account under **Settings → Users
and permissions** in Search Console.

## What Narrative reads

| Data | Used for |
| - | - |
| Clicks, impressions and average position by date, page and query | Per-page search performance in Site Health and the SEO module |
| Queries per page | Real demand evidence for campaign recommendations, and the searches a published page is measured against |
| The property's verified sites | The picker, and the *Search Console verified* check in the audit library |

Query strings from Search Console are treated as untrusted text: they are
stored as data and never executed or passed to a model as instructions.

## Permissions

| Scope | Used for |
| - | - |
| `webmasters.readonly` | Listing your Search Console properties and reading the Search Analytics report for the one you choose |

Narrative does not request URL Inspection or sitemap submission permissions.

## Disconnect

**Personalize → Connectors → Google Search Console → Manage → Disconnect**
revokes the permission with Google and deletes the stored credential.
Imported search readings are kept so your history stays readable; reconnect
at any time to resume the daily import.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.