# Integrations



The Integrations page (**Workspace** → **Integrations**) is where you connect Google accounts to your workspace. Once an account is connected, any domain in the workspace can link to a specific Search Console property from its own Google Search Console page.

Connections are workspace-wide. You don't need to authenticate separately for each domain – connect once, then link as many domains as you like.

## Connecting a Google Account [#connecting-a-google-account]

1. Click **Integrations** in the workspace sidebar.
2. Click **Connect Google Account**.
3. You're redirected to Google's consent screen.
4. Sign in and grant **Google Search Console** access (read-only).
5. After consent, you're redirected back to the Integrations page and the new account appears in the list.

<Callout type="info">
  You can connect multiple Google accounts to the same workspace – useful if different domains live under different Google identities. Each domain links to one specific property when you set up that domain's connection.
</Callout>

## Connected Accounts List [#connected-accounts-list]

Each connected account row shows:

| Column              | What it means                                                                                              |
| ------------------- | ---------------------------------------------------------------------------------------------------------- |
| Email               | The Google account email                                                                                   |
| Status              | **Connected** (green) or **Reconnect** (amber) when the OAuth token has expired                            |
| Added               | When the account was first connected                                                                       |
| Refresh / Reconnect | Both re-run the Google authorization flow (Refresh for a healthy connection, Reconnect for an expired one) |
| Delete              | Remove the connection (trash icon)                                                                         |

### Reconnecting an Expired Account [#reconnecting-an-expired-account]

Google access tokens expire periodically. If a connection lapses, the row shows a **Reconnect** badge.

1. Click **Reconnect** on the affected row.
2. Complete the Google OAuth flow again.
3. Existing GSC links on your domains continue working – no need to re-link.

### Deleting a Connection [#deleting-a-connection]

1. Click the trash icon on the account row.
2. Confirm in the modal.
3. Any domain linked to a property under that account loses its link and stops receiving GSC data until you connect a new account and re-link.

## Linking a Domain to a Property [#linking-a-domain-to-a-property]

The Integrations page connects accounts at the workspace level. Linking a domain to a property for the first time happens on that domain's **Google Search Console** page.

1. Open the domain you want to connect.
2. Click **Google Search Console** in the domain sidebar.
3. Pick a property from the list to link it.

The domain's **Edit** page shows the currently linked property afterwards, with **Change** and **Remove** actions if you need to swap or unlink later.

## Permissions and Privacy [#permissions-and-privacy]

VitalSentinel requests **read-only** scopes only. We never modify your GSC properties.

Data is fetched on a schedule and stored encrypted in your workspace. Disconnecting an account stops further fetches; previously fetched data remains available until its [retention window](/others/data-privacy#retention) elapses. Search Console data is kept for 10 years on every plan. See [Data & Privacy](/others/data-privacy) for details.

## When an Account Needs Re-Authentication [#when-an-account-needs-re-authentication]

If a connected Google account stops working - the grant is revoked, the password changes, or Google expires it - a red **Google Account Authentication Required** panel appears on your main dashboard, listing every affected account by email and workspace with a **Re-authenticate** link straight to that workspace's Integrations page. The domain's own Search Console page shows the same notice.

Collection stops while an account is in that state, for Search Console and for [Indexing](/features/indexing-monitoring) alike, because both read the same Google connection. Re-authenticating resumes it.

## Troubleshooting [#troubleshooting]

### No properties show up when linking [#no-properties-show-up-when-linking]

* The Google account doesn't have access to any GSC properties.
* Confirm the account has access to properties in [Search Console](https://search.google.com/search-console).
* Reconnect the account to refresh permissions.

### Status stays on "Reconnect" after re-authorizing [#status-stays-on-reconnect-after-re-authorizing]

* Google occasionally requires a full disconnect-reconnect cycle. Delete the account from the Integrations list and connect it fresh.

### Wrong account is being used [#wrong-account-is-being-used]

* If multiple Google accounts are connected, each domain explicitly links to one property. Open the domain's edit page and pick the correct property from the dropdown.

## Related [#related]

<Cards>
  <Card title="Google Search Console" href="/features/google-search-console">
    What GSC data shows up after linking
  </Card>

  <Card title="Adding a Domain" href="/getting-started/adding-domain">
    Per-domain property selection
  </Card>
</Cards>