# Google OAuth Token

SEO Utils uses Google OAuth Tokens to securely connect to your Google accounts and access Google Search Console 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.

## 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 Tokens menu.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-31d3820c9706b803d13517057000ee9d8d300cd7%2FXnapper-2025-08-05-22.48.22.png?alt=media" alt="" width="375"><figcaption><p>Click on Google OAuth Tokens menu to manage your connections</p></figcaption></figure>

### Step 2: Connect Your Google Account

Click the "**Connect**" button in the top-right corner of the Google OAuth Tokens page.

<figure><img src="https://1176579443-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2DwV6sJBiKjUHMDggb4d%2Fuploads%2Fgit-blob-e77c6d5e18f229079480303248d77b260baeba8b%2FXnapper-2025-08-05-22.48.57.png?alt=media" alt=""><figcaption><p>Click the Connect button 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
2. **Review the permissions** that SEO Utils is requesting
3. Click "**Allow**" to grant SEO Utils access to your Google Search Console 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 data. It cannot modify or delete any data in your GSC 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 Google OAuth Tokens list with your email address and profile picture.

<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 properties across different Google accounts.

Simply click the "**Connect**" button again and follow the same authorization process with a different Google account.

### Remove a Google Account

To disconnect a Google account:

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 "**Delete**" from the dropdown menu
4. Confirm the deletion when prompted

{% hint style="warning" %}
Removing a Google account will disconnect all associated Google Search Console properties from SEO Utils. You'll need to reconnect the account to access that GSC data again.
{% 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) 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)).
3. Try disconnecting and reconnecting the account

### Token Expired

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

1. Simply delete the affected account from the list
2. Click "**Connect**" to re-authorize the account

## 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 deleting the account from SEO Utils