Setup Clarity

Install tracking code

Tip

Want to check out what Clarity is? Try our live Demo.

You need to install the tracking code to start using Clarity on your website. Each website you add to your Clarity account will have its unique tracking code to install. Each website you add to your Clarity account will have its unique tracking code to install. You can add the same script to multiple subdomains of your website.

  1. Select a project and go to Settings -> Setup. Learn how to add a project here.

    Navigating to Setup section.

  2. Choose an installation method with which you would like to proceed further.

    Choose an installation method.

There are three ways to install Clarity:

Note

  • After installation, it can take up to 2 hours to start seeing data.
  • By default, Clarity masks all sensitive content on your site.

Install manually

Note

To set up Clarity, you need access to your website's <head> section.

  1. To manually install, select Get tracking code.

    Select get tracking code.

  2. Copy the code and paste it into the <head> section of your website or web app.

    Copy tracking code.

Install on a third-party platform

You can install Clarity tracking code on third-party platforms like Shopify, SquareSpace, Wix, WordPress, and more. Check the list of supported third-party platforms to know more.

  1. Select View all platforms for a list of supported platforms.

    Select view all platforms.

  2. Setup Clarity using any of the listed platforms. Follow the setup instructions on each platform as you select one.

    View supported platforms.

  3. If your platform isn't listed, select I don't see my platform to submit a request.

    Select I don't see my platform.

  4. Enter the platform name and select Submit. While we'll try to support your platform in the future, you can install the code manually to start using Clarity immediately.

    Submit platform request.

Share code with your team member

Choose this method if you like to share the code with a team member who can help you set up Clarity.

  1. Select Share code.

    Select share code.

  2. Enter your team member's email ID and select Submit. We'll send an email to your teammate with the tracking code and setup instructions.

    Enter email ID and select submit.

Verify your Installation

There are two ways to verify if Clarity is installed correctly:

View your Clarity project

Once the script is added, find your project's Recordings, Heatmaps, and Dashboard data in 2 hours.

Check POST requests

See POST requests to https://www.clarity.ms/collect while interacting with your site. Here are the steps to view the request:

  1. Right-click on your website and select Inspect.

    Right click and select inspect.

  2. Go to the Network tab and select collect file. You can view the POST request as shown below.

    Go to network and select collect.

  3. Once you see the data on your project dashboard, explore Heatmaps to see how users interact with your website.

Setup Integrations

Optionally, using this section, you can integrate and manage Google Analytics, Google Tag Manager, and Google Optimize.

Google Analytics Integration

Google Analytics integration allows Clarity to link session playbacks with your Google Analytics dashboard.

Select Getting started if you wish to integrate and learn more about Google Analytics integration.

Select getting started in GA integration.

Google Tag Manager Integration

Google Tag Manager integration is automatically detected.

  1. Select Finish setup if you wish to integrate.

    Select finish setup on GTM.

  2. If you wish not to integrate, select Sign in with a different account.

  3. Select a GTM account, GTM container from the drop-down, and select create and publish.

    Select create and publish.

Google Optimize Integration

Clarity automatically detects if your project is running active Google Optimize experiments. Clarity will enable the integration for you when there is at least one Google Optimize experiment session.

Google optimize integration.

Advanced Settings

Manage cookies and fraud detection through advanced settings.

Cookies

Clarity uses cookies to gather session data. Toggle the button to turn on cookies.

Cookies in advanced settings.

Recordings won't be linked together into multi-page sessions if this setting is turned off. Learn how to customize the usage of cookies.

Turn off cookies.

Fraud Detection

By default, Clarity analyzes form input fields to detect fraudulent activity. This service is currently in BETA. Toggle the button to turn on the detection. Clarity will be unable to detect fraudulent activity if this is turned off.

Turn on fraud.

Clarity Compatibility

Clarity will work on most sites with little code. It requires some modern browser APIs but should never throw exceptions on older browsers.

Though any site architecture is supported, Clarity can't capture what's inside your website's Canvas or third-party iFrame elements.

FAQ

For answers to common questions, refer to Setup FAQ.

Visit Clarity