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

# Google Search Console

> Google Search Console reports how a site performs in Google Search. Connect it to WPOS and the agent can use it as part of the work it does on your site.

Google Search Console reports how your site performs in Google Search: the queries people search, your ranking positions, click-through rates, and indexing problems. Connected to WPOS, the agent can read that data and act on it in the same session, beside your site's live preview.

**Category:** Analytics and SEO   **Actions available:** 9+

## What you can do

* Read search performance by query, page, country, and device
* Check whether a URL is indexed, and why it is not
* Pull impressions, clicks, and average position over a date range

## Example requests

Once Google Search Console is connected, ask in the [Command Center](/operate/command-center):

```text theme={null}
Show me the queries where we rank on page two.
Which pages lost impressions this month?
Rewrite the meta description for our highest-impression page.
```

## Before you connect

* A **verified property** in Search Console. Unverified sites return no data.
* **Full** or **Restricted** user access on the property. Restricted users cannot submit URLs for indexing.
* Know whether yours is a domain property (covers every subdomain) or a URL prefix property (exact match only). They report different data.

## Connect it

<Steps>
  <Step title="Open WPOS">
    In WordPress admin, open **WPOS**. You land on the chat screen.

    <Frame caption="WPOS opens on the chat screen.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/01-wpos-home.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=44b957fe1852b63e94425e51af9912e0" alt="The WPOS chat screen in WordPress admin." width="1918" height="876" data-path="images/connectors/google-search-console/01-wpos-home.png" />
    </Frame>
  </Step>

  <Step title="Open a new tab and choose Connectors">
    Click the **+** button to open the launcher panel, then choose **Connectors**.

    <Frame caption="The launcher panel. Connectors is the fifth entry.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/02-new-tab-connectors.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=8c095f7530a5f4ee85b9612acf885c25" alt="The WPOS launcher panel listing Preview, Site tree, Files, Skills, Connectors, and Settings." width="1920" height="887" data-path="images/connectors/google-search-console/02-new-tab-connectors.png" />
    </Frame>
  </Step>

  <Step title="Find the connector">
    Every available connector is listed alphabetically, each with a button showing what it needs.

    <Frame caption="The Connectors panel, sorted alphabetically.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/03-connectors-list.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=5ea071445681819482c2d9b3d84a5b6e" alt="The WPOS Connectors panel listing Calendly, Canva, Figma, Google Analytics, Google Calendar, and Google Docs." width="1913" height="891" data-path="images/connectors/google-search-console/03-connectors-list.png" />
    </Frame>
  </Step>

  <Step title="Search and press Connect">
    Type `Google Search Console` into **Search for integrations**, then press **Connect**.

    <Frame caption="The button reads Connecting while the popup opens.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/04-search-connecting.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=8b96fea44c130682116586e1edce4b41" alt="The Google Search Console row showing Connecting." width="1918" height="885" data-path="images/connectors/google-search-console/04-search-connecting.png" />
    </Frame>
  </Step>

  <Step title="Choose your Google account">
    Pick the account that has access to the verified property.

    <Frame caption="Google asks which account to connect.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/05-google-account-chooser.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=d4df024a8b7187175eb8ba76ce0da8a4" alt="Google's account chooser, headed to continue to Composio." width="1917" height="886" data-path="images/connectors/google-search-console/05-google-account-chooser.png" />
    </Frame>
  </Step>

  <Step title="Grant access">
    Review the request and click **Continue**.

    <Note>
      This screen has two shapes. On a first authorization Google shows permission **checkboxes that start empty**, and you must tick **Select all**. Once Composio already holds access for your account it shows the shorter "Composio already has some access" screen with just Cancel and Continue, as pictured.
    </Note>

    <Frame caption="The short consent screen, shown when access already exists.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/06-google-consent.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=b679c74fe8e884a32ff2584a5daac292" alt="The Google consent screen showing Composio already has some access." width="1920" height="887" data-path="images/connectors/google-search-console/06-google-consent.png" />
    </Frame>
  </Step>

  <Step title="Confirm in WPOS">
    The row reads **Connected** with a **Disconnect** button, and a green "Google Search Console connected" banner appears in the chat.

    <Frame caption="Connected, with the confirmation banner in chat.">
      <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/07-connected.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=e8fc93c8a9660b88cdc3903dc99639eb" alt="The Google Search Console row showing Connected." width="1908" height="886" data-path="images/connectors/google-search-console/07-connected.png" />
    </Frame>
  </Step>
</Steps>

## Disconnect

Press **Disconnect** on the row. A red "Google Search Console disconnected" banner confirms it, and the row returns to **Connect**.

<Frame caption="Disconnecting returns the row to its unconnected state.">
  <img src="https://mintcdn.com/wpos/xCBpSE-QeFfm67KI/images/connectors/google-search-console/08-disconnected.png?fit=max&auto=format&n=xCBpSE-QeFfm67KI&q=85&s=1ef9a5519401d90c59d8286ca4abd0c3" alt="The Google Search Console row back to Connect, with a red disconnected banner in the chat." width="1918" height="888" data-path="images/connectors/google-search-console/08-disconnected.png" />
</Frame>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connected, but every query returns no data">
    On a first authorization the permission checkboxes were left unticked. Disconnect, reconnect, and tick **Select all**.
  </Accordion>

  <Accordion title="Data is missing for the last few days">
    Search Console lags by two to three days. This is Google behaviour, not a WPOS problem. Ask for ranges ending a few days back.
  </Accordion>

  <Accordion title="A domain property returns unexpected numbers">
    Domain properties aggregate every subdomain and both protocols. For one hostname only, use the matching URL prefix property.
  </Accordion>
</AccordionGroup>

For popup failures, expired connections, and other issues shared across every
connector, see [Introducing Connectors](/connect/connectors).