> For the complete documentation index, see [llms.txt](https://help.seoutils.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.seoutils.app/guide/google-oauth-token.md).

# Google OAuth Token

SEO Utils uses your Google accounts to securely read your Google Search Console data and your Google Analytics 4 (GA4) data. This allows you to pull GSC data directly into SEO Utils for advanced analysis and reporting that the standard GSC interface doesn't provide, and to [add GA4 properties](https://help.seoutils.app/guide/google-analytics-4.md) without a service account.

**Settings → Google Oauth Token** lists each Google account once, with a badge for every tool it is connected for.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-58aef7148e14a01dc2fa76c9b462bd9b628763e9%2Fgoogle-oauth-token-accounts-list.png?alt=media" alt="The Google accounts list in Settings with Search Console and GA4 badges per account"><figcaption><p>Connect for GA4 (1) or Search Console (2) from the top right; the Connected for column (3) shows the badges</p></figcaption></figure>

| Badge              | The account can be used for                                                           |
| ------------------ | ------------------------------------------------------------------------------------- |
| **Search Console** | [Search Console properties](https://help.seoutils.app/guide/google-search-console.md) |
| **GA4**            | [GA4 properties](https://help.seoutils.app/guide/google-analytics-4.md)               |

## Connect Your Google Account

### Step 1: Access Google OAuth Tokens

Open the SEO Utils app on your machine, and locate the Settings menu in the left sidebar. You will see the **Google Oauth Token** menu.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-d8cd5ec2c197955e903239df050bddfed85b16a2%2FXnapper-2025-08-05-22.48.22.png?alt=media" alt="" width="375"><figcaption><p>Click the Google Oauth Token menu (1) to manage your Google accounts</p></figcaption></figure>

### Step 2: Connect Your Google Account

In the top-right corner of the page, click "**Connect for Search Console**" to read Search Console data, or "**Connect for GA4**" to read Google Analytics 4 data.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-5a0c192d5521c5b0d12232629f46c677c8519ad3%2FXnapper-2025-08-05-22.48.57.png?alt=media" alt=""><figcaption><p>Click Connect for Search Console (1) or Connect for GA4 (2) to start the authorization process</p></figcaption></figure>

### Step 3: Authorize SEO Utils

After clicking Connect, your default web browser will open with Google's authorization page. Follow these steps:

1. **Select your Google account** that has access to Google Search Console or to your GA4 properties
2. **Review the permissions** that SEO Utils is requesting
3. Click "**Allow**" to grant SEO Utils access to your Google Search Console data, or to your Google Analytics data (**See and download your Google Analytics data**)

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-8c67ab7f335593035e6daffa6424270a1ea644d2%2FXnapper-2025-08-05-22.49.34.png?alt=media" alt=""><figcaption><p>Review and allow the requested permissions</p></figcaption></figure>

{% hint style="info" %}
SEO Utils only requests read-only access to your Google Search Console and Google Analytics data. It cannot modify or delete any data in your GSC or GA4 account.
{% endhint %}

### Step 4: Authorization Complete

Once you've authorized access, you'll see a success message in your browser. You can close the browser tab and return to SEO Utils.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-74a1088b39595f6663df43099643f9a963361aef%2FXnapper-2025-08-05-22.50.43.png?alt=media" alt=""><figcaption><p>Authorization successful - you can close this tab</p></figcaption></figure>

Your connected Google account will now appear in the list with your email address and a **Search Console** or **GA4** badge. A message on the page offers the next step: **Add GA4 Property** or **Add Search Console property**.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-09929a247777a0daca5df66fd559b97e7ed97b6d%2FXnapper-2025-08-05-22.51.09.png?alt=media" alt=""><figcaption><p>Your connected Google account</p></figcaption></figure>

## Managing Multiple Google Accounts

You can connect multiple Google accounts to SEO Utils. This is useful if you manage GSC or GA4 properties across different Google accounts.

Click "**Connect for Search Console**" or "**Connect for GA4**" again and follow the same authorization process with a different Google account.

To connect an account already in the list for the other tool, open the three-dot menu (⋯) on its row and choose "**Connect for GA4**" or "**Connect for Search Console**". The menu offers the tool the account is missing.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-49323fd302d2b7a383bdaafeaa2a04507f849ad9%2Fgoogle-oauth-token-row-menu.png?alt=media" alt="The row menu of an account connected for Search Console, with Connect for GA4 and Remove from Search Console"><figcaption><p>Open the row menu (1) to connect the account for GA4 (2) or remove it from Search Console (3)</p></figcaption></figure>

{% hint style="info" %}
Each tool keeps its own sign-in for the account. Connecting or removing one never changes the other: an account connected for both stays connected for Search Console when you remove it from GA4, and the other way round.
{% endhint %}

### Remove a Google Account

To disconnect a Google account from a tool:

1. Find the account you want to remove in the list
2. Click on the three-dot menu on the right side of the account row
3. Select "**Remove from Search Console**" or "**Remove from GA4**" (one for each tool the account has)
4. The item asks first, in place, for example "Remove from GA4? GA4 properties read with it stop syncing." Click "**Yes**" to remove the account from that tool, or "**Cancel**" to keep it

{% hint style="warning" %}
Removing a Google account from Search Console disconnects its Google Search Console properties from SEO Utils. Removing it from GA4 stops the GA4 properties read with that account from syncing until you connect the account for GA4 again. Reconnect the account to bring the data back.
{% endhint %}

## Using Google OAuth with GSC Integration

Once you've connected your Google accounts, you can use them with various [Google Search Console integration](https://help.seoutils.app/guide/google-search-console.md) features in SEO Utils:

* **Performance Analytics**: Complete search data with advanced regex filtering and more than 16 months of history
* **Keyword Cannibalization Detection**: Identify when multiple pages compete for the same keywords, hurting your rankings
* **Bulk Mentions Analysis**: Check if target keywords appear in critical SEO elements:
  * Page titles and meta descriptions
  * H1, H2, and other headings
  * Body content and paragraphs
  * Image alt text and captions
* **Optimization Opportunities**: Data-driven insights showing:
  * Pages ranking 4-10 that need small tweaks to reach top 3
  * High-impression keywords missing from your content
  * Title/meta description improvements for better CTR
  * Quick wins based on position and mentions analysis
* **Bulk URL Indexing**: Submit multiple URLs to Google for indexing at once
* **Sitemap Management**: Monitor and manage your XML sitemaps directly

## Troubleshooting

### Authorization Failed

If the authorization process fails:

1. Make sure you're selecting a Google account that has access to Google Search Console
2. Check that you're allowing all the requested permissions
3. Try clearing your browser cache and cookies, then attempt the connection again

### Account Not Showing GSC Properties

If your connected account doesn't show any GSC properties:

1. Verify that the Google account has been added as a user in Google Search Console
2. Check that the account has at least "Read" permissions for the properties (needs "Owner" permissions to check index status if using the [Auto Indexing tool](https://help.seoutils.app/guide/auto-indexing-tool.md)).
3. Try disconnecting and reconnecting the account

### Token Expired

Google OAuth tokens may occasionally expire. If you see errors about expired tokens:

1. Click "**Connect for Search Console**" (or "**Connect for GA4**" for a GA4 error) and sign in with the same Google account again
2. If that does not help, remove the account from that tool as described above and connect it again

## Privacy & Security

* SEO Utils stores OAuth tokens securely on your local machine
* Tokens are never transmitted to any external servers except Google's APIs
* You can revoke access at any time by removing the account from SEO Utils
