# 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 Google Analytics 4 property or Search Console property from its own settings 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 access to:
   * **Google Analytics 4** (read-only)
   * **Google Search Console** (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 | Force a token refresh or restart the OAuth flow                                 |
| 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 GA / 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 GA and 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. Picking which property a specific domain uses happens on the domain's **Google Analytics** or **Google Search Console** module page – not on the domain edit page.

1. Open the domain you want to connect.
2. Click **Google Analytics** or **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 GA or 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 your plan's retention window elapses. See [Data & Privacy](/others/data-privacy) for details.

## Troubleshooting [#troubleshooting]

### "No properties available" when linking [#no-properties-available-when-linking]

* The Google account doesn't have access to any GA4 or GSC properties.
* Confirm the account has access to properties in [Google Analytics](https://analytics.google.com) and [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="Google Analytics" href="/features/google-analytics">
    What GA4 data shows up after linking
  </Card>

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