Google Analytics integration


To Start using Clarity, you must finish the Setup process.

Integrating your Clarity project with Google Analytics allows Clarity to put a convenient link to session playbacks within your Google Analytics dashboard. Once you identify the sessions that you need more information on, jumping to Clarity will let you see exactly what your user saw - enabling you to debug and understand pain points for your users.

How does Clarity integration work?

Clarity will create a custom dimension called the 'Clarity Playback URL'. Data will start flowing into Google Analytics from the Clarity JavaScript that you've added to your site without any additional changes from you.


Not all sessions will have a playback URL. Clarity saves your users' bandwidth by only uploading full fidelity playbacks for a subset of page views.

Here are the steps to integrate Google Analytics into Clarity.



At this point you can only add one web property to integrate with Clarity.

Step 1

Choose a project and navigate to 'Settings' tab.

Go to 'Setup' and select 'Getting Started' under the 'Google Analytics integration' section.

Getting started in Google Analytics.

Step 2

You will be redirected to Google to sign in. If you have already signed in, select the account you wish to use or choose 'Use another account' to sign in.

Google pop up to sign in.

If you haven't already signed-up, you'll need to sign up for Google Analytics to continue.

Step 3

Once you signed in, select the web property you would like Clarity to send data. Select 'Continue'.

Google Analytics web property selection.

Step 4

You will be redirected to the Clarity Setup page. Toggle the 'Active' button.

Activate Google Analytics integration.

Deactivating web property

If at any time you would like to temporarily disable the upload to Google Analytics, you can toggle back the 'Active' button.

Deactivate Google Analytics integration.

Disconnect Google Analytics integration


Once you disconnect your project, it will be removed from your Google Analytics account and you need to redo the installation process to use Clarity.

Step 1

Choose a project and navigate to 'Settings' tab.

Go to 'Setup' and select 'Disconnect project from Google Analytics' under the 'Google Analytics integration' section.

Disconnecting Google Analytics integration selection.

Step 2

Confirm 'Disconnect' on the pop-up window.

Disconnecting Google Analytics integration confirmation.


For more answers, refer to General FAQ.

Can I Integrate any web property with Google Analytics?

Yes. All you would need is to follow the steps mentioned above.

Do I need to install Clarity tracking code for Google Analytics integration?

Yes. You would need to finish Setup process to start using Clarity's integration with Google Analytics.

Can my team access Google Analytics integration?

As long as your team has access to your Google Analytics web property, they can see the custom dimension Clarity utilizes.

How many web properties can I integrate?

At this point, you can integrate only one web property.

Why do I see a failure when connecting with Google Analytics?

When integrating with Google Analytics, Clarity will attempt to create a custom dimension on your behalf. There are a few reasons this could fail, including a limit on the number of custom dimensions Google enforces per web property. If integrating is unable to complete, try creating a new dimension or editing an unused dimension with the following values:

Name: Clarity Playback URL

Scope: Session

Active: checked

Visit Clarity