Frequently asked questions

Note

Clarity should not be used on sites that contain Sensitive Data including user health care, financial services or government related information. For more information, please see the Clarity's Terms of use.

About Clarity

What is Clarity?

Clarity is a user behavior analytics tool, which helps you understand how users are interacting with your website. Supported features include:

  • Session Recordings
  • Heatmaps
  • ML Insights

Why should I use Clarity?

The unique features of Clarity, which help you understand user behavior include:

  • Simple and easy customization makes Clarity best for your business.
  • Clarity won't get in the way of your site's performance.
  • Data is analyzed and ready to view in near real time, so you don't have to wait.
  • There are absolutely no limits on the number of sites per account. Clarity can scale to support even the largest websites.
  • Clarity process more than 1 petabyte of data from over 100 million users per month. Also, there are no traffic limits on these sites.
  • Deep AI and Machine Learning algorithm powered insights help you analyze the user behavior in an efficient way.
  • No sampling.

What is the pricing model for Clarity?

Clarity is a free service.

How does clarity work?

Visit Clarity Overview page to know more. You can also try live Demo to experience Clarity's analysis tools, Session Recordings, and Heatmaps.

Where can I use Clarity?

Few scenarios where Clarity can be best used but not limited to:

  • Enable your clients or management in making data driven decisions on what works and what does not.
  • Test what content works best and where to place it on your page.
  • Understand confusing elements of your webpage.
  • Identify user behavior and add required content to your page.
  • Test and publish new ideas on to your webpage.
  • Study user clicks and scrutinize the requirements.

Privacy

Is Clarity GDPR compliant?

Clarity is GDPR complaint as a data controller for visitors and co-controller for the data gathered by the Clarity script on your website. For more information, see Microsoft Privacy Statement.

How does Clarity comply with CCPA?

Clarity processes data in compliance with the California Consumer Privacy Act (CCPA). For more information, see Microsoft Privacy Statement.

What is Clarity's Privacy Policy?

Refer to Terms of use to know the Privacy Policy.

What data does Clarity collect?

Clarity captures the user interactions on your website such as how the page has rendered and what interactions your user had on your website such as mouse movements, clicks, scrolls, etc. The code to capture this information is open source and available on GitHub. You can choose to mask your users' data. For more information, see Microsoft Privacy Statement.

Yes. For more information, see Clarity Terms of use.

Where is my data stored?

Your data is stored in Microsoft Azure cloud service.

Who has access to my data?

Microsoft/Clarity has access to the data. For more information, see Clarity Terms of use.

How long will web admins be able to access their Clarity data?

The data will be retained for web master's consumption up to a period of 12 months from the time of recording.

Can I delete data for a specific user?

You need to delete the entire project if you need to delete your user's data.

What content can Clarity record?

By default, Clarity suppresses entire client content. The website admin controls the content to be sent to Clarity and website owners should utilize their dashboard settings to block confidential content.

Can my visitors choose not to be recorded?

No. The Website Admins will have to remove the Clarity tracking code.

Do you sell my data?

Clarity does not sell data. For more information, see Microsoft Privacy Statement.

Is there an option for Do-Not-Track setting?

Clarity does not currently respond to browser DNT signals. For more information, see Microsoft Privacy Statement.

Getting started

How do I start using Clarity?

Onboarding to Clarity is free and easy. If you are new to Clarity, start by signing up. Refer to Setup to start installing the Clarity tracking code.

Can anyone sign up? Are there any restrictions?

Financial, Government, and Medical websites should not onboard onto Clarity. Read Clarity's Terms of Use to know more.

Will Clarity work on my site?

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

Which site architectures do Clarity support?

Though any site architecture is supported, Clarity won't be able to render inside 'iframe' or 'canvas' elements.

Which browsers do Clarity support?

Clarity supports all browsers that execute JavaScript. This includes all modern browsers.

Does Clarity require any special software to run?

No. To run Clarity on your website, you would need access to your website's <head> section and finish the Setup process.

Can I use Clarity on different subdomains?

Yes. You can use Clarity on multiple subdomains under the same website. Add your project's script to each subdomain and page you want to be instrumented. Refer to Setup to know how to manually install the script.

How do Clarity collect clicks?

Clarity track and collect mouse events through the installed tracking code of the project, by choosing the best screenshot to ensure that the top elements are included. Top elements are ranked in order of clicks on a page. Element ranking is absolute in aggregate to all page views for a given set of filters.

Does Clarity support funnels?

No. Clarity does not support this feature.

Does Clarity overload my site?

No. Clarity is designed with performance as one of the topmost priorities. Hence, there is no perceivable impact to your site's end user.

Project management

How do I create a project?

Adding a project can be done in three simple steps. You can add unlimited number of projects for each domain or website.

Can I modify my project details later?

If you are an Admin of the project, you can modify the project settings such as, changing the project name and site category. For more information, see Project management.

Can I delete my project?

Yes. Remember, you will not be able to recover any data associated with the project after you delete it. You can delete a project only if you are an Admin of the project. Deleting a project will remove it completely for all team members. You will not be able to undo this action. Follow these steps to delete a project.

Can I delete my project's data?

You cannot delete data without deleting the project. Check here to know how to delete a project.

Setup

How do I start using Clarity?

To start using Clarity, you would need access to your website's <head> section to manually include the Clarity tracking code. Each website you add to your Clarity account will have its unique tracking code to install. For more information, see Setup.

When will I start seeing data on the Clarity dashboard?

Once you finish installing the script on your website, Clarity will start collecting the data. You can view this data in your project dashboard within 2 hours of adding the script. You can verify by following these steps.

How can I verify Clarity is running correctly?

There are two ways to verify if Clarity is running correctly on your website. Check Verification to know more.

Will Clarity tracking code interfere with other JavaScript code?

No. Clarity tracking code will not interfere with other JavaScript code of your website.

Can I install my project's tracking code on multiple sites?

To better use Clarity, we recommend to setup a new project for different domains.

Can I use Clarity to find bugs in my website?

Yes. All Clarity features are aimed at helping you find bugs easier. For example, Session Recordings gives you various ways to filter and drill down to what you're looking for.

When can I start using Clarity after installing the tracking code?

In general, wait for 2 hours for Clarity to start working on your website.

I am unable to add the tracking code. What should I do?

Make sure you are following the Setup steps and copying the right tracking code. Check Troubleshooting installation to know more.

Masking and unmasking content

Can I mask or unmask text on certain parts of the page?

Yes. Check here to know more.

Team management

Can I add team members to my project?

Yes. Once you sign up to Clarity and add a new project, you will be Admin of the project. You can only add team members if you are an Admin of the project.

Admins can add team members through their email IDs. There is no limit on number of users to a project. However, only 10 pending invites are allowed at a time. Check here to start adding your team.

How many members can I invite to my project?

You can only add team members if you are an Admin of the project. There are no limits to the number of members you can add to each project. However, only 10 pending invites are allowed at a time.

What user roles are available for my team members?

A user can be an Admin and Team member. Admins have the following permissions:

  • Changing the user role.
  • Deleting a project.
  • Update or modify project settings.

For more information, see Project access.

What are the different permissions for each role?

Check Project access to know Admin and Member permissions.

Is there a limit on number of admins per project?

No. There's no limit on number of Admins for a project. There can multiple admins for each project. You can also change a team member to Admin.

How do I change the user roles in my project?

A user can be an 'Admin' or 'Team member'. You can only change user roles if you are an Admin of the project. For more information, see change user role.

Can I remove users from my project?

If you are an Admin of the project, you can remove team members. Removing a user will deny them access to a project. You will be able to add the user to your project again.

What should I do if my team member didn't receive the invite?

  • Make sure you've entered a valid email address in the invite.
  • If the recipient's email is of official account, make sure that the organization's IT team allow emails from **@microsoft.com**.
  • Ask the team member to check their spam or bulk email folders.
  • Check troubleshooting guide for more details.

Google Analytics integration

How can I integrate Google Analytics with Clarity?

Check Google Analytics integration to know more.

Can I Integrate any web property with Google Analytics?

Yes. All you would need is to follow the step-by-step guide.

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

Yes. You would need to finish the 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

Custom tags

Can I send additional data through Clarity filters?

Yes. You can send any information that you would like to send to Clarity like session data through custom tags.

How can I setup custom tags?

Learn more on how to set and use custom tags here.

How soon is the tag available on my project?

As you add a tag in your website code, it will be updated in your project within 30 minutes to 2 hours.

How many tags can I add to my website?

There are no limits on number of tags you can add to your website. However, a single page can have no more than 128 tags. Any additional tags will be ignored.

How to use custom tags to find out users who haven't used a feature?

Define the feature in custom tag and add the custom tag to your project to start using it. For more information, see Custom tags.

Insights

What is a Rage click?

Rage click helps you view recordings when a user repeatedly clicks in a clustered area within a short period of time.

Example: Find bugs in UI where a user clicked repetitively on an element (expecting a response) or became frustrated during site navigation.

For more information, see Rage click.

What is a Dead click?

Dead click helps you view recordings where a user clicked somewhere on the page but there was no response detected.

Example: Find UX bugs where an element may look clickable (and receives user clicks) but has no coded response on click.

For more information, see Dead click.

What is Excessive scrolling?

Excessive scrolling detects when a user scrolls through site content at a higher rate than expected for standard content consumption.

Example: Find recordings where your users scrolling quick to look for a specific piece of content. This helps you find layout alignment issues, identifying important content.

For more information, see Excessive scrolling.

What are Quick backs?

Quick backs help view recordings when a user goes to a new page then quickly returns to the previous one.

Example: Find recordings where your users had a confusing navigation, like, quickly returning to your site's home page after attempting to click on a follow-on page.

For more information, see Quick backs.

Can I view general insights of specific element on all pages?

Currently, this feature is not supported.

Heatmaps

Will Heatmaps slow down my site?

Heatmap is created based on the data already collected by Clarity and doesn't gather extra information. So Heatmap will not slow down your site.

Can I use Heatmaps and follow privacy regulations?

Yes. You can follow all privacy regulations, mask text, and still create Heatmaps. Clarity creates Heatmap based on element attributes and not the content of the element.

Does Heatmaps support on Mobile devices?

Yes. Heatmaps work on mobile, tablet, and desktop devices.

How long is Heatmaps data retained?

You can access Heatmaps for up to 12 months.

How long will it take for a user click to show on a Heatmap?

The user clicks are shown on Heatmaps within 30 minutes.

Which sites can use a Heatmap?

All websites where Clarity tracking code is installed can use a Heatmap.

Can I upload my own images to a Heatmap?

Clarity doesn't support uploading or recapturing of screenshot to match a Heatmap.

Can I track iFrames with Heatmaps?

Clarity captures clicks on first party iFrames (that is, iFrames source is the same domain as original page source) but not on third-party iFrames.

How can I add conditions to Heatmaps?

You can add/modify filters to view Heatmaps in specific conditions.

Can we exclude elements from Heatmaps?

No. Clarity doesn't support to exclude or suppress specific elements on your webpage while generating a Heatmap.

Can I view a Heatmap for my Shopify or WordPress site?

Yes. You can view Clarity Heatmaps on Shopify or WordPress site where the Clarity tracking code is installed.

What types of Heatmaps can I analyze using Clarity?

Using Clarity, you can analyze Click maps and Scroll maps to understand user behavior.

How can I search through the URLs?

You can use the autofill search box to search through the URLs.

Does Clarity collect more click data than that's displayed in the dashboard?

Yes. Clarity can't show all the data that it is collected. The displayed data is dependent on the sample impression on which the heat is created.

How does Clarity Click maps deal with pop-ups?

For pop ups, go to the corresponding Recording and then select Insights Dashboard to start viewing aggregate stats.

How do Clarity display a Click map for varied screen length, resolution, and device type?

Resolution and device type will not affect a Click map. A Click map is generated based on the aggregated data of elements of the page that user clicked across all screen sizes.

Why do I see more clicks than page views?

This happens when there are one or more users click on the page more than more page views.

What's the maximum limitation on a Heatmap?

Heatmaps are limited up to 100,000 page views per Heatmap.

What are Heatmaps limitations?

For more information, see Heatmaps limitations.

Can I create a Heatmap for dynamic elements?

Yes. Heatmaps for dynamic elements can be created on demand through the corresponding recording. This feature is coming soon.

Filters

Can I add custom filters?

Yes. Check Custom tags to know more about custom filters.

Is Regular Expression supported in path filters?

Currently Regular Expressions are not supported in path filters.

How can I find users who interacted with a specific page within a session?

To watch users who interacted with a specific page within a session, set Visited URL to that specific page and Page click count greater than one click.

How can I find user recordings leaving the page before viewing the entire page?

Set page scroll depth to different points to see when users are leaving before reaching the bottom of the page.

How can I examine new page's traffic?

To understand users traffic to a new page, set Visited URL to that specific page and Time frame to new site's start date. Set Insights filters to find out user interaction with the site.

Which filters can I use to compare various technologies?

Use Browser, Operating system, Device, to compare various technologies.

Can I choose specific time frame to search through my recordings?

Yes. Check Time frame to know how to set custom time frame.

What defines a session in Clarity?

Session is the amount of time a user spent on your site.

Can I filter internal IP?

Clarity does not support this feature.

Visit Clarity