Frequently asked questions

Clarity is a user behavior analytics tool that helps you understand how users interact with your website. Supported features include:

• Session Recordings
• Heatmaps (or heat maps)
• ML Insights

Clarity offers many unique features that help you understand user behavior:

• Simple and easy customization makes Clarity best for your business.
• Clarity doesn't impede 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 processes 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 user behavior efficiently.
• No sampling (that is, tracking only a portion of your site's traffic).

Clarity is a free service forever. You never encounter traffic limits or are compelled to upgrade to a paid version. Learn more.

Visit the Clarity overview page for more details. You can also try the live Demo to experience Clarity's analysis tools, Recordings, and Heatmaps.

Use Clarity in some or all of these scenarios (and more):

• Enable your clients or management in making data-driven decisions on what works and what doesn't.
• 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 your webpage.
• Study user clicks and scrolling behavior.

No, not at all. Visitors to your site notice no change in site speed or performance. The Clarity JavaScript is asynchronous. It doesn't affect how quickly a website loads.

Clarity is GDPR-compliant as a data controller. For more information, see the Microsoft Privacy Statement.

Clarity processes data in compliance with the CCPA. For more information, see Microsoft Privacy Statement.

Refer to Terms of use to know the Privacy Policy.

Clarity captures the user interactions on your website such as, how the page is rendering, user interactions such as mouse movements, clicks, scrolls, and so on. The code to capture this information is open source and available on GitHub. You can also read a summary of what data fields we collect. You can choose to mask your users' data. For more information, see Microsoft Privacy Statement.

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

Your data is stored in the Microsoft Azure cloud service.

Clarity customers in the EU are contracting with Microsoft Ireland Operations Limited (MIOL), which has a special contract (SCCs) with Microsoft Corporation (in the United States) allowing cross-border data transfers between those affiliate entities. Clarity customers shouldn't worry about cross-border data transfer restrictions because they're sending data to another EU company (MIOL).

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

The data is retained for the webmaster's consumption up to 30 days from the time of recording.

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

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

No. The website administrators need to remove the Clarity tracking code.

Clarity doesn't sell data. For more information, see Microsoft Privacy Statement.

Clarity doesn't currently respond to browser DNT signals. For more information, see Microsoft Privacy Statement.

We utilize the system built by the Digital Advertising Alliance to enable opt-out experiences for customers. You can opt out of Clarity telemetry by selecting Microsoft here. If you install the Protect My Choices app for your browser, you can ensure your opt-out preference is saved.

Clarity functionality won't be affected by Chromium's deprecation of third-party cookies.

Clarity features rely on first-party cookies, which are set by the visited website and remain unaffected by Chromium's plans. Clarity continues to operate normally for all browsers. Clarity customers don't need to take any action.

Any third-party cookies used by Clarity are to support operational purposes like advertising. These third-party cookies no longer function under Chromium's plans and won't disrupt your website's experience.

To comply with GDPR and local regulations, explicit user consent is required before placing cookies on their devices.

Without explicit consent, Clarity cookies can't be used. This means that some functionalities, like funnel tracking and session recordings, might be impacted.

To ensure continued compliance with applicable data protection laws and Microsoft terms and policies, Clarity consent signal enforcement is updated for websites using Clarity in select markets in the European Economic Area (EEA). This update requires that for all incoming requests from end users located within the EEA, and for websites targeting the EEA, Clarity webmasters need to convey end user consent status to Microsoft through the methods outlined in the Clarity client API documentation. We understand that these changes might require some adjustments on your end. Assistance is available to support the configuration process. Reach out to customer support for any questions regarding website configuration.

Refer to the Clarity Client API documentation for detailed guidance on how to call the API.

Onboarding to Clarity is free and easy. If you're new to Clarity, start by signing up. Refer to the Setup section on how to install the Clarity tracking code.

Yes. There are no restrictions.

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

Learn how to troubleshoot sign up issues.

Learn how to troubleshoot installation.

Though any site architecture is supported, Clarity can't render inside third-party 'iFrame' or 'canvas' elements.

Clarity supports all browsers that execute JavaScript, which includes all modern browsers.

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

Yes. Projects span multiple sites if you included the tracking code from your project on all of them.

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. Check Setup instructions on how to install the script manually.

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

Yes. For more information, see Funnels documentation.

No. Clarity is designed with performance as one of the topmost priorities. So there's no perceivable impact on your site's end users.

You can reach us via email at clarityMS@microsoft.com. You can also select the smiley face icon at the top right of the screen from any Clarity page.

Yes. You can find us at Stack Overflow by tagging your questions with ms-clarity. We monitor questions with that tag.

For more information, see Troubleshooting Installation.

For more information, see Troubleshooting Installation.

See the answer in Troubleshooting Installation.

See the answer in Troubleshooting Settings.

See the answer in Troubleshooting Settings.

Yes, you can track multiple domains within one account. Just create different projects for each domain.

No, we don't combine link data. Suppose you have the same link at the top and bottom of your page. You can see the number of clicks on the top versus the bottom.

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

Once you finish installing the script on your website, Clarity starts collecting the data. It takes a few hours to view data in the dashboard.

There are two ways to verify if Clarity is running correctly on your website. Learn how to verify your installation.

No. The Clarity tracking code doesn't interfere with other JavaScript codes of your website.

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

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

You can instantly start using Clarity starting with Clarity real time recordings.

Ensure you follow the Setup steps and copying the right tracking code. For more information, see Troubleshooting installation.

Clarity plays nicely with many popular website tools, including WordPress, Shopify, Woo Commerce, Google Tag Manager, Wix, and more. Check the list of supported platforms. If your favorite platform isn't listed, let us know. We'll consider your feedback when we prioritize future updates to Clarity.

Make sure to update your Shopify installation after major design changes. Design changes might cause the Clarity script to be removed. If your Shopify site updates its design (like switches to a new template), confirm that your Clarity script is still correctly installed.

No, Microsoft Clarity doesn't support authentication via your company's AAD instance. However, users from your company should be able to log into Clarity using their company email accounts, which might require your admin's approval. See our troubleshooting tips for help.

Bot traffic can come in various forms and behaviors, and advanced bots might even avoid carrying obvious behavior signatures. Clarity is continually improving our detection to cover all cases, and you might occasionally see sessions that resemble bot behavior slip through.

No.

Yes. Learn how to mask and unmask.

Upon selecting a masking mode, look at the top of the page. The masking mode is set correctly if the Masking mode set dialogue box with a green tick mark appears.

Yes. Contact Clarity support to request URL parameter masking.

Here's an example:

Unmasked URL parameters: <https://www.contoso.com/search?q=hello+world>

Masked URL parameters: <https://www.consto.com/search?q=*na*>

Note:

For URLs, Masking only applies to page URL. Currently, it doesn't apply to other URLs that Clarity captures such as:

• Referrer URLs
• Clicked URLs (the URLs that are captured when a user clicks on the page).
• The URL parameter's name, which is case-sensitive, is the basis for the masking.

In a project, the masking is applied to all the URLs that use that URL parameter. You can't apply the masking to just a subset of URLs.

Content in the input boxes is masked in all modes and can't be customized.

Currently, Clarity doesn't mask content within style sheets or style tags. Hence, it's recommended not to host sensitive content within CSS.

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

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

If you can't see your project in My Projects, ensure you supplied the correct authentication provider and email address when you signed in. Otherwise, send us feedback using the smiley face button on the Clarity top menu.

Yes. Remember, you can't recover any data associated with the project after deleting it. You can delete a project only if you're an Admin of the project. Deleting a project removes it completely for all team members. You can't undo this action. Learn how to delete a project.

You can't delete data without deleting the project. Learn how to delete a project.

Clarity can't restore deleted projects. You need to create a new project and add the new tracking code to your webpage.

You can't view project details unless you verify the site's ownership, due to privacy concerns. Learn how to troubleshoot the project access.

You can use the existing project. Make sure that the Clarity script is still installed on all the pages of the website associated with the project.

'Drop in traffic' are the notification emails to notify admins of the project about a significant traffic drop that exceeded 50% in page views compared to the previous week.

Yes. Go to Manage Account and opt in for Email notifications of Clarity digest.

Yes. Once you sign up to Clarity and add a project, you're an Admin of the project. You can only add team members if you're an Admin of the project.

Admins can add team members through their email IDs. There's no limit on the number of users to a project. However, only 10 pending invites are allowed at a time. Learn how to add team members.

You can only add team members if you're 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.

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

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

For more information, see Project access.

Check Project access to know Admin and Member permissions.

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

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

If you're an Admin of the project, you can remove team members. Removing a user denies them access to a project. You can add the user to your project again.

• Ensure you enter a valid email address in the invite.
• If the recipient's email is from an official account, ensure that the organization's IT team allows emails from @microsoft.com.
• Ask the team member to check their spam or bulk email folders.
• Check the troubleshooting guide for more details.

For more information, see Troubleshooting Settings.

See the answer in Troubleshooting Settings.

It's easy. Just follow the steps in Google Analytics integration documentation.

Yes. All you would need is to follow our documentation.

Yes. You need to finish the Clarity Setup process before integrating with Google Analytics.

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

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

Clarity attempts to create a custom dimension on your behalf while integrating with Google Analytics. There are a few reasons that it could fail, including a limit on the number of custom dimensions Google enforces per web property. If you can't integrate Clarity completely, try creating a new dimension or editing an unused dimension with the following values:

Name: Clarity Playback URL

Scope: Session

Active: checked

Check the blog post to know more.

There's no delay. After integrating with Google Analytics, you'll see GA segments in the Recordings tab.

GA segments only work in the Recordings tab.

GA segments can be managed directly on Google Analytics. If you want to edit or delete your GA segment, you can directly do that on Google Analytics. Clarity reflects the changes once you refresh the project.

Learn how to create goals and how to use GA goals in Clarity.

Learn why use GA goals.

Yes. You can use custom tags to send any information you would like to Clarity, such as page labels).

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

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

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

Rage clicks occur when a user repeatedly clicks in a clustered area within a short period.

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

For more information, see Rage click.

Dead clicks occur when a user clicked somewhere on the page, but no response was detected.

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

For more information, see Dead click.

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

Example: Find recordings where your users scroll quickly to look for a specific piece of content. This helps you identify important content and find layout alignment issues.

For more information, see Excessive scrolling.

Quick backs occur when a user goes to a new page and quickly returns to the previous one.

Example: Find recordings where your users had 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.

Currently, this feature isn't supported.

In addition to viewing session recordings with JavaScript errors, view the most common pages and browsers with errors. You can also easily filter to those segments and many more. Currently you can't view specific script error names automatically, but this feature is in development.

Yes. Just apply one or more filters and then save it as a segment to easily access later. Learn more.

Content insights card is automatically applied for most WordPress blog sites. For other sites, follow the Setup instructions to get started.

For more information, see Troubleshooting dashboard.

Clarity distinguishes each user through a unique identifier stored in their browser through a first-party cookie for your website. Each user is identified separately for each browser or device they use. For instance, if a user named "Mona Kane" accesses your website using a mobile phone, a tablet, and a PC, Clarity would register as three unique users. For more information, see Clarity cookie documentation.

Not at all. Heatmaps use data that Clarity already collects.

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

Yes. Clarity supports heatmaps across devices. By default, Heatmaps are generated for PC, tablet, and mobile for easy comparison.

You can access heat maps for up to 13 months.

It's quick-less than a minute.

The user clicks are shown on heat maps within 30 minutes.

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

Clarity doesn't support uploading or recapturing screenshots to match a heat map.

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.

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

No. Clarity doesn't support excluding or suppressing specific elements on your webpage while generating a heat map.

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

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

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

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

Go to the corresponding Recording for pop-ups and then select Insights Dashboard to start viewing aggregate stats.

Resolution and device type doesn't affect a click map. Clarity generates click maps based on the aggregated data of elements of the page that the user clicked across all screen sizes.

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

Heat maps are limited to up to 100,000 page views per heat map.

Clarity heatmaps do account for dynamic elements, such as dropdown menus, pop-ups, and so on. However, dynamic elements might not be visible in the default heatmap. But that is easy to change. The left panel ranks all elements, including dynamic ones, by clicks. Just select the element you want to explore, and the heatmap refreshes to show it.

Yes, regular expressions are supported for all path filters (visited, entry, exit, and referral URLs) for heatmaps and recordings. Learn more.

For more information, see Heatmaps limitations.

Check Troubleshooting Heatmaps for more details.

See the answer in Troubleshooting Heatmaps.

For more information, see Troubleshooting Heatmaps.

See the answer in Troubleshooting Heatmaps.

No. Conversion maps isn't supported on Mobile Apps.

Some website images might not appear in heatmaps if the sample impression didn't load the image. You can use the live extension or change screenshots as a workaround.

Clarity session recordings aren't video streams of users interacting with your site. Instead, this is how they work: Clarity records all the page information a user sees (the DOM content) and the actions they take as they browse your site. A session recording is an animation that captures all user actions across devices, such as mouse movements, clicks, scrolls, and more.

Clarity tracks all sessions, but recordings might not be available for all sessions.

Recordings appear instantly as soon as you add the tracking code. For more information, see Clarity real time.

Clarity records up to 100,000 sessions per project per day.

First, make sure the CSS for your page is available externally without the need for authentication. If that doesn't work, leave us some feedback in the app using the smiley face button.

Currently, you can't delete or download specific recordings.

When watching a session recording, select the "More details" button to get a detailed breakdown of the user's journey in the session.

Yes. Once you view a recording, the text on that recording card dims. See our documentation to learn more.

Remove the Clarity tracking code from the URLs you don't want to be recorded.

For more information, see Troubleshooting recordings.

While the user is inactive on your page, Clarity doesn't capture changes for continuously changing elements such as images, videos, etc. In that case, these elements show up gray. It goes back to full color if the user becomes active on the page again.

Clarity retains recordings for 30 days from the time of recording. However, Favorite recordings and randomly selected sample of recordings are retained for up to 13 months.

You can view a maximum of 100 live sessions.

You can only add five labels per recording.

Yes. You can create up to 1,000 labels per project.

Labels can be retained for up to 13 months.

Check how to create labels and how to add an existing label.

Your team members who can access the project also can access the labels, but the labels can't be shared.

Any team member with access to a project can create labels.

Yes. For more information more about custom filters, see Custom tags.

Currently, regular expressions aren't supported in path filters.

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

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

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

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

The session is the amount of time a user spends on your site.

Clarity supports blocking internal IP addresses.

Yes. You can combine multiple filters and save this user group as a "Segment." Learn more.

Find them in the JavaScript errors filter drop-down. Scroll down past the JavaScript section.

Yes. Using OR or AND option, you can filter multiple JavaScript errors or Click errors on a page. Selecting "any JavaScript error" filters to all JavaScript errors logged for your site. For more information, see JavaScript errors filter.

For Heatmaps, a screenshot of a click map or a scroll map is shared. And for Recordings, the entire recording is shared.

You can share Heatmaps and Recordings with your team members or guests. While the link shared with team members doesn't expire, the link shared with guests has an expiration.

No. You can add multiple IDs from your team and outside your team.

The link shared with your project team never expires.

The link shared with guests expires based on the number of days you select while sharing the link.

• The Purchases feature is only available on Clarity projects of Shopify sites.
• Checkout Abandonment feature is only available on Clarity projects of Shopify Plus sites.
• If you still can't see these widgets or filters, submit feedback from your Clarity account (using the smiley button on the top-right of your screen).

0% Purchases mean Clarity didn't detect any sessions on your site that resulted in a purchase.

0% Checkout abandonment means Clarity didn't detect any sessions on your site that started the Checkout Process but abandoned before completing the purchase.

Customers paying with ShopPay or expedited checkout options don't have their sessions showing up under the Abandonment card.

This occurs if the session doesn't include a "Checkout Confirmed" page. Suppose the user selected "Complete Order", but the session terminated before officially landing on a "Checkout Confirmed" page. In that case, Clarity still considers this session as abandoned before completing the Checkout.

This occurs if the session doesn't receive data indicating the next page was reached. Suppose the user selected "Go to Payment", but the session terminated before landing on the Payment page. In that case, Clarity still considers this session as abandoned before reaching the Payment step.

The "Other" step contains miscellaneous scenarios that aren't captured by the previous steps. This includes Express Checkout, more custom steps like "Processing", and so on.

Heatmaps are generated for specific URLs. The core steps (Contact Info, Shipping Method, Payment) are associated with their respective URLs. "Other" contains miscellaneous scenarios that span multiple URLs.

Clarity calculates the Purchase Conversion rate from the data that we receive from your site. This data might not always receive the same payloads or full session scope as Shopify. As such, there might be minor differences in the rate reported. Feel free to let us know if this difference is large with the Feedback button (Smiley button on top-right of your screen).

For more information, see Troubleshooting Dashboard.

For more information, see Troubleshooting Dashboard.

See the answer in Troubleshooting Dashboard.

Clarity live is a browser extension that helps you quickly view users interaction with your site in real time. You can view instant heatmaps, area maps, and watch recordings for any page you're on. Learn more about Clarity Live Extension.

Clarity is 100% free - forever. You're never asked to upgrade to a paid version. No credit card is required to sign up.

Clarity live extension is easy to use. Start by downloading the extension on Chrome Web Store. Learn how to use the widget and its features.

Currently, Clarity live extension is only available on the Google Chrome Web Store. You can now add extensions from Chrome Web Store to Microsoft Edge. Select 'Add to Chrome'. Check how to install the extension.

For more information, see Troubleshooting guide.

Setting up Clarity on UET is easy. On the Microsoft Ads portal, navigate to your interested UET tag. Select the checkbox to enable Clarity. Once enabled, a Clarity account is created for you and a Clarity tag is placed on the pages that have that UET tag. For more information, see UET-Clarity user guide.

To disable Clarity insights, you might uncheck the Enable Microsoft Clarity box in Microsoft Advertising under Edit UET tag settings. Check the announcement to learn more on how to opt out.

Clarity Website Benchmarks is in beta version as we're currently working on improving the categorization's accuracy, the categories' relevance, and the tool's global coverage.

The following are the various categories:

1. Arts: Design, Movies, Music, Television, and so on.
2. Business: Investing, Jobs, Real Estate, and so on.
3. Computers: Hardware, Internet, Security, Software, and so on.
4. Games: Gambling, Role play games, Video games, and so on.
5. Health: Beauty, Fitness, Medicine, Nutrition, and so on.
6. Home: Consumers, Cooking, Family, and so on.
7. Kids & Teen: School time, Teen life, and so on.
8. News: Media, Newspapers, Weather, and so on.
9. Recreation: Food, Humor, Outdoors, Travel, and so on.
10. Reference: Education, Journals, Libraries, Maps, Museums, and so on.
11. Science: Biology, Physics, Psychology, and so on.
12. Shopping: Clothing, Food, Gifts, and so on.
13. Society: Issues, People, Religion, and so on.
14. Sports: Baseball, Basketball, Soccer, and so on.

Each website is categorized using a machine learning classifier based on the website's HTML main page.

Yes. Offline sessions are captured and uploaded when the device is connected to the internet within a specific number of days. However, currently offline mode is currently not available for iOS. This functionality is still under development.

The Clarity SDK is designed to be efficient and cognizant of critical application contexts to avoid causing a perceptible performance impact on the host application. Contact Clarity support if you notice a significant performance drop.

Uploaded recordings could take up to 2 hours to be available for playback. If the data doesn't appear post 2 hours, verify the initialization steps for both Android and iOS. Additionally, you can also set the SDK log level to LogLevel.Verbose in the configuration for Android and iOS to view if there are any issues reported in the logs.

Just update the SDK version you use in your build.gradle dependencies section.

If Clarity was installed using Swift Package Manager, open XCode and show Project Navigator. Right click on Clarity under Package Dependencies and select Update Package. If Clarity was installed using CocoaPods, run pod update Clarity command in the folder containing Podfile.

Clarity starts recording your users' behavior once they open the app and stops once they send it to the background or close it. If the app comes again into focus within a 30-minute interval from session start, recording resumes, else the session expires and a new session begins.

Make sure you're using cordova-android version +11.0.0.

Some applications use large or heavy assets/typefaces. This message indicates that Clarity is in the process of downloading these assets to reconstruct the user session for playback.

Currently, Clarity Mobile React Native Plugin supports both Android and iOS. You can view the recordings or heatmaps for users who used your app on Android and iOS devices. However, Clarity supports only Android for the Cordova and Ionic plugins.

Running plugins with native code is currently not supported while developing Expo Go. This restriction leans more in the Expo Go direction. We suggest creating a new version of your app with the Clarity React Native SDK installed using EAS, as a workaround.

Note:

Integrating Clarity won't block your development cycle with Expo Go. Clarity won't run if you integrate it, but the rest of your app should continue to work normally. This won't prevent you to develop for Expo Go. Unlike Expo Go, if you're using Expo, Clarity should function smoothly during your development cycle.

Note: This was fixed in versions later than 1.2.3.

Clarity assumes strict mode until the client's masking setting are fetched from Clarity's servers to ensure safety. The process of fetching these configurations could take some time, which would cause the device's first session to appear masked. However, If you close the app and reopen it, the sessions should comply with the masking mode set for the project.

Currently, Clarity ignores Admob ads in session playback.

Most likely, the user ID that you provided doesn't comply with the user ID setup guidelines. Hence, Clarity SDK sets the value you specified in the customUserID field and generates a random userID. If you provided a value for the CustomUserID, Clarity still generates a random value for userID and uses the value you provided for customUserID.

Use clarity-compose package instead of clarity. Refer to Jetpack Compose Support.

Check the supported Jetpack Compose versions in Platform/Framework Support Matrix.

Clarity is now mobile-friendly supporting mobile browser. You can now easily navigate through Clarity on a mobile device for a quick view of the project.

Compared to desktop view, mobile view has limited support. You can view dashboard and recordings. Currently, Project creation, Settings, Heatmaps, GA dashboard, Filters, and Segments aren't supported.

You can only view projects but can't add projects, through mobile browser.

Currently, you can't apply filters in mobile view. However, select a dashboard widget to filter and view recordings.

Currently, Visitor profile isn't supported on mobile view.

Clarity automatically detects and groups user actions on your website into nine known event types:

• Purchase
• Add to Cart
• Begin Checkout
• Contact Us
• Submit Form
• Request Quote
• Sign Up
• Login
• Download

If Clarity doesn't detect actions for these nine event types, you don't see any auto events for your project. However, you can create new smart events completely code-free by navigating to Settings -> Smart events. Learn more about how to create smart events.

Currently, Visitor profile isn't supported on mobile view.

Heatmap insights are a feature of Copilot in Clarity that intakes your heatmap data for a specific URL and generates a summary.

Heatmap insights generate a detailed summary of your URL's heatmaps, with built-in links to highlighted elements and relevant heatmap views. This enables you to quickly understand key user behavior insights about your URL and dive deeper as needed.

This feature currently supports summarization across the following heatmaps for all three devices: last clicks, first clicks, rage clicks, dead clicks, and scroll. It doesn't require any manual user input.

Heatmap insights are intended to help Clarity users more easily and quickly understand their website's analytics.

Heatmap Insights is built on generative AI, which creates new content. As with any AI system, there's risk of generating ungrounded content, which is why we added clickable links to corresponding data.

• Make sure to double check the outputs and verify takeaways before applying them.
• Keep in mind that takeaways from Copilot in Clarity shouldn't be treated as expert recommendations.

Another known limitation of generative AI is the inability to make mathematical computations. Heatmap insights don't perform these computations; instead, they analyze different heatmap data comparatively. If you observe any sort of inaccurate computation, share your feedback using the thumbs up/down button or email us at clarityMS@microsoft.com to help us learn and improve.

Chatting with Copilot in Clarity takes your question and outputs a natural language response, based on its understanding of your dashboard data.

Chat with Copilot to generate responses to queries about your dashboard data, adding more suggestions or built-in links to relevant filters. This enables you to quickly understand key user behavior insights about your website and dive deeper as needed.

Chatting with Copilot is intended to help Clarity users more easily and quickly understand their website's analytics.

Chatting with Copilot in Clarity was developed in accordance with Microsoft's responsible AI principles. We evaluate Copilot's output regularly on quality and performance, using metrics for fairness, reliability, safety, and more.

Chatting with Copilot is powered by generative AI, which creates new content. As with any AI system, there's a risk of generating ungrounded content. To address this, we added clickable links to corresponding data. Ensure to double-check the outputs and verify the takeaways before applying them. Chat's takeaways shouldn't be considered as expert recommendations.

Another limitation of generative AI is its inability to perform mathematical computations. Chat doesn't perform these calculations directly but provides specific functions for our database to execute. If you notice any inaccurate computations, provide feedback to Clarity team.

Chatting with Copilot might help you interpret your Clarity dashboard, link you to the correct filters, or explain certain information. Chatting with Copilot isn't optimized to be used for your Clarity recordings or heatmaps. Clarity offers an OFF toggle in Settings, for users who don't want to continue using Clarity's Copilot features.

Visit Clarity