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

# Google Search Console

> Connect Google Search Console to monitor search performance, submit sitemaps, and inspect index status

**Status:** Available | **Complexity:** Beginner | **Setup time:** 2-3 minutes

The Google Search Console (GSC) integration connects your Google account to ChatFeatured so you can submit sitemaps, monitor search performance, and inspect URL indexing status — all without leaving the dashboard. GSC data is also surfaced inside the Site Audit so you can see how each audited page is actually performing in Google.

<Info>
  Google Search Console is a **Pro** feature. Upgrade your brand to access this integration.
</Info>

## Features

<CardGroup cols={3}>
  <Card title="Sitemaps" icon="sitemap">
    Submit one or more sitemap URLs and view their indexing status, errors, and submitted URL counts.
  </Card>

  <Card title="Search Performance" icon="chart-line">
    See clicks, impressions, CTR, and average position for your pages and queries — with click-to-expand drill-down.
  </Card>

  <Card title="URL Inspection" icon="magnifying-glass">
    Check the index status of any URL, including coverage state, robots.txt state, last crawl time, and canonical URLs.
  </Card>
</CardGroup>

## Setup Requirements

* A Google account with access to at least one Google Search Console property
* Pro plan access on the brand you're connecting
* Workspace admin role (only admins can connect or disconnect integrations)

<Tip>
  If you don't have a Search Console property yet, [open Search Console](https://search.google.com/search-console) and add your site first. Both **domain properties** and **URL-prefix properties** are supported.
</Tip>

## Connect Google Search Console

The integration uses a separate Google OAuth flow scoped specifically to Search Console — connecting it will **not** affect the Google account you use to sign in to ChatFeatured.

### Step 1: Open the Integration

1. In ChatFeatured, go to **Integrations** in the sidebar
2. Find **Google Search Console** under the **SEO** filter (or in the full integrations list)
3. Click **Open**

### Step 2: Connect Your Google Account

1. Click **Connect Google Search Console**
2. You'll be redirected to Google to grant the following permissions:
   * View and manage Search Console data for your verified sites
3. Select the Google account that has access to your Search Console properties
4. Click **Continue** to authorize

After authorization, you'll be redirected back to ChatFeatured and the connection will show as **Connected**.

### Step 3: Select Your Brand Domain

Once connected, choose which Search Console property to use for this brand:

1. From the **Brand Domain** dropdown, select the property you want to use
2. Both `sc-domain:` (domain properties) and `https://` (URL-prefix properties) are supported
3. Your selection is saved automatically and used across the platform for this brand

<Warning>
  If no properties appear, make sure the Google account you connected has access to at least one Search Console property. You can add or share access at [search.google.com/search-console](https://search.google.com/search-console).
</Warning>

***

## Using the Integration

Once a property is selected, three tabs become available on the integration page.

### Sitemaps

View and manage the sitemaps Google has indexed for your property.

**Submitted Sitemaps table** shows:

* Sitemap URL and type (sitemap or sitemap index)
* Date submitted and date last read by Google
* Total submitted URL count
* Status (Success, Pending, Warning, or Error counts)

**Submit a new sitemap:**

1. Enter one or more sitemap URLs (e.g., `https://example.com/sitemap.xml`)
2. Click **Add another** to submit multiple at once
3. Click **Submit Sitemap** — ChatFeatured calls the Search Console API and reports per-URL success or failure

<Tip>
  Submit your sitemap right after publishing new content for faster discovery by Google.
</Tip>

### Search Performance

See how your site is actually performing in Google Search.

**Dimensions:**

* **Pages** — Each URL with its clicks, impressions, CTR, and average position
* **Queries** — Each search query users searched to find you

**Time periods:** 24 hours, 7 days, 28 days, or 3 months

**Drill-down:** Click any row to expand it:

* Expand a **page** to see the top queries driving traffic to it
* Expand a **query** to see which pages are ranking for it

**Filter & sort:** Use the search box to filter by URL or query, and click any column header to sort by clicks, impressions, CTR, or average position.

**Inspect from the table:** When viewing pages, click the search icon on any row to jump straight to URL Inspection for that page.

### URL Inspection

Check whether a specific URL is indexed and how Google sees it.

1. Enter the full URL (e.g., `https://example.com/blog/post-name`)
2. Click **Inspect**

The inspection returns:

| Field                | What It Means                                 |
| -------------------- | --------------------------------------------- |
| **Verdict**          | Overall result — `PASS`, `NEUTRAL`, or `FAIL` |
| **Coverage State**   | How Google has indexed (or excluded) the URL  |
| **Indexing State**   | Whether the URL is indexable                  |
| **Robots.txt State** | Whether your robots.txt allows crawling       |
| **Last Crawl Time**  | When Googlebot last fetched the page          |
| **Google Canonical** | The URL Google selected as canonical          |
| **User Canonical**   | The canonical URL declared in your page       |

Results are **cached for 24 hours** to stay within Google's API quota. Click **Refresh** on any result to force a fresh inspection.

<Tip>
  Use the **View in Google Search Console** link below any inspection to open the full report in the GSC UI.
</Tip>

***

## Site Audit Integration

When Google Search Console is connected, GSC data appears inline within the [Site Audit](/using-chatfeatured/site-audit):

* Each audited page shows a **GSC summary** (clicks, impressions, CTR, position)
* A **Queries** tab appears on each page detail view, showing the top search queries driving traffic to that specific URL
* Use this to prioritize fixes on pages that already get search impressions

***

## API Quotas

Google Search Console enforces per-property API limits:

| API                    | Limit                           | How ChatFeatured Handles It                      |
| ---------------------- | ------------------------------- | ------------------------------------------------ |
| **URL Inspection**     | 2,000 requests/day per property | Results cached 24h; force-refresh available      |
| **Sitemap submission** | No hard daily limit             | Rate-limit errors (HTTP 429) are surfaced to you |
| **Search Analytics**   | Generous limits                 | Refresh on demand from the dashboard             |

***

## Managing the Connection

### Reconnect

If Google permissions change or tokens are revoked, click **Reconnect** under **Manage Connection** to re-run the OAuth flow.

### Disconnect

To remove the integration:

1. Open **Manage Connection** on the integration page
2. Click **Disconnect**
3. Confirm the dialog

Disconnecting removes the connection and all cached URL inspection data. You can reconnect at any time.

<Note>
  Disconnecting from ChatFeatured does **not** revoke the OAuth grant in your Google account. To fully revoke access, visit [Google Account permissions](https://myaccount.google.com/permissions).
</Note>

***

## Troubleshooting

<Accordion title="No properties show up after connecting">
  **Cause:** The Google account you authorized doesn't have access to any Search Console properties.

  **Solution:**

  * Open [Search Console](https://search.google.com/search-console) with the same Google account
  * Add a property or ask the property owner to grant your account access
  * Return to ChatFeatured and click **Refresh** on the property selector
</Accordion>

<Accordion title="Sitemap submission fails">
  **Cause:** The sitemap URL isn't reachable, isn't valid XML, or is outside the property scope.

  **Solution:**

  * Verify the sitemap loads in a browser at the URL you submitted
  * Make sure the sitemap is on the same domain as the selected GSC property
  * For `sc-domain:` properties, any subdomain works; for URL-prefix properties, the sitemap must be on the exact prefix
</Accordion>

<Accordion title="URL Inspection returns 'Unknown' verdict">
  **Cause:** Google hasn't yet crawled the URL, or the URL is outside the selected property.

  **Solution:**

  * Confirm the URL belongs to the property you selected in the Brand Domain dropdown
  * Submit the URL's sitemap first so Google discovers it
  * Wait 1-7 days after submission for Google to crawl, then re-inspect
</Accordion>

<Accordion title="Rate limit (HTTP 429) errors">
  **Cause:** You've hit Google's daily quota for that property (most commonly 2,000 URL inspections/day).

  **Solution:**

  * Wait until the quota resets (24h rolling window)
  * Rely on cached inspection results in the meantime — they remain valid for 24h
</Accordion>

<Accordion title="Connection shows an error after working previously">
  **Cause:** OAuth tokens were revoked in your Google account, or the connected user no longer has access to the property.

  **Solution:**

  * Click **Reconnect** under **Manage Connection** and re-authorize
  * If you still see errors, disconnect and reconnect from scratch
</Accordion>

***

## See Also

* [Site Audit](/using-chatfeatured/site-audit) — See GSC performance data inline on each audited page
* [Index Submissions](/index-submissions/index-submissions) — Submit URLs to AI search engines (ChatGPT, Perplexity, Claude)
* [Agent Analytics](/using-chatfeatured/agent-analytics) — Track AI crawler activity alongside Google traffic