---
title: How to Connect Analytics Tools
description: "OneSuite's analytics integrations add your own Google Tag Manager, Google Analytics or Microsoft Clarity tracking to your Client Portal. They track visitor activity inside the portal, so you can see how clients use it in the tools you already work…"
url: "https://help.onesuite.io/docs/how-to-connect-analytics-tools/"
updated: "2026-10-01"
category: Integrations
---

# How to Connect Analytics Tools

OneSuite's analytics integrations add your own Google Tag Manager, Google Analytics or Microsoft Clarity tracking to your Client Portal. They track visitor activity inside the portal, so you can see how clients use it in the tools you already work with.

**In this guide you'll learn how to:**

- Check that your business can use analytics integrations
- Add a Google Tag Manager Container ID
- Add a Google Analytics Measurement ID
- Add a Microsoft Clarity Project ID
- Change an ID you already saved

## Before you start

- Analytics integrations need the White Label add-on. Without it, each tool's page shows **You have to buy White label addons to use this feature.** with an **Upgrade** button that opens the **Manage Billing** page.
- Tracking runs on your custom domain. Set one up in **Settings**, **White Label**, **Domain** before you expect data. Your tracking code is not loaded when the portal is opened on the OneSuite domain.
- The **Analytics** page needs access to your business's admin settings. If you can't see it, ask an admin.
- Have your ID ready from the analytics tool's own account.

## Where are the analytics settings?

The analytics tools are in **Settings**, **Integrations**, **Analytics**, and the same page is in **Settings**, **Client Portal**, **Analytics**.

1. Click your name at the bottom of the sidebar, then **Settings**.
2. Under **Integrations**, click **Analytics**.
3. Click the settings button on the tool you want to set up: **Google Tag Manager**, **Google Analytics** or **Microsoft Clarity**.

When your business has the add-on, each tool page shows a **Custom domain** box at the top. It shows your domain and its progress, such as **DNS configured** or **Step 1 completed**. If no domain is set up, it shows **No custom domain configured.** with a **Set up domain** button.

## How to add Google Tag Manager

You add Google Tag Manager by entering your Container ID, which starts with `GTM-`.

1. Open **Settings**, **Integrations**, **Analytics**.
2. Click the settings button on **Google Tag Manager**.
3. Enter your ID in **Container ID**, for example `GTM-XXXXXXX`.
4. Click **Submit**.

## How to add Google Analytics

You add Google Analytics by entering your Measurement ID, which starts with `G-`.

1. Open **Settings**, **Integrations**, **Analytics**.
2. Click the settings button on **Google Analytics**.
3. Enter your ID in **Measurement ID**, for example `G-XXXXXXXXXX`. The page notes that you find it in your Google Analytics property under **Admin > Data Streams > Web**.
4. Click **Submit**.

## How to add Microsoft Clarity

You add Microsoft Clarity by entering the Project ID from your Clarity project settings.

1. Open **Settings**, **Integrations**, **Analytics**.
2. Click the settings button on **Microsoft Clarity**.
3. Enter your ID in **Project ID**.
4. Click **Submit**.

## What each field accepts

Each field checks the format before it saves.

| Tool | Field | Format | What the page says it does |
| --- | --- | --- | --- |
| Google Tag Manager | **Container ID** | `GTM-` followed by at least 4 letters or numbers | Enables tracking and analytics on the Client Portal. |
| Google Analytics | **Measurement ID** | `G-` followed by at least 4 letters or numbers | Enables tracking and analytics. |
| Microsoft Clarity | **Project ID** | Letters, numbers, hyphens and underscores only | Enables session recordings and heatmaps for the Client Portal. |

If the format is wrong, the field shows a message such as **Use format G-XXXXXXXXXX (e.g. G-XXXXXXXXXX)** or **Project ID can only contain letters, numbers, hyphens and underscores**.

## How to change a saved ID

Open the tool's page, replace the ID in the field and click **Update**. Once an ID is saved, the button reads **Update** instead of **Submit**.

Not using OneSuite yet? Start your free trial →

## FAQs

### What do OneSuite analytics integrations track?

They track visitor activity inside your Client Portal. Google Tag Manager and Google Analytics enable tracking and analytics, and Microsoft Clarity enables session recordings and heatmaps. You view the data in each tool's own account.

### Why is the Submit button greyed out on the analytics page?

Your business doesn't have the White Label add-on yet. The page shows **You have to buy White label addons to use this feature.** Click **Upgrade** to open the **Manage Billing** page.

### Why am I not seeing any data in Google Analytics?

Check that your custom domain is set up and that clients open the portal on it. Your tracking code loads only on your custom domain, so visits on the OneSuite domain are not tracked.

### Where do I find my Google Tag Manager Container ID?

It is in your Google Tag Manager account and starts with `GTM-`, for example `GTM-MNB52VFM`.

### Can I just add the tracking code to my own website instead?

Your website's code doesn't run inside the Client Portal. To see how clients use the portal itself, add the ID in OneSuite so the tag loads on your portal's custom domain.

## What to do next

**Brand the portal:** Set the look and navigation clients see with [Client Portal Customization](https://help.onesuite.io/docs/client-portal-customization/).

**Learn the portal:** See what clients can do after they sign in with [The OneSuite Client Portal](https://help.onesuite.io/docs/client-portal/).

**Check your add-ons:** Review your plan and add-ons in [How to Manage Your OneSuite Subscription](https://help.onesuite.io/docs/how-to-manage-your-onesuite-subscription/).
