Microsoft Clarity Tutorial: How to Set Up and Use It in 2026

This Microsoft Clarity tutorial shows how to set up and use Microsoft Clarity in 2026 to understand where website visitors click, scroll, hesitate and abandon important tasks. You’ll learn how to install Clarity on WordPress, through Google Tag Manager or manually; verify data collection; and turn heatmaps, session recordings, Smart Events and funnels into website improvements. For a related search-acquisition use case, see our Microsoft Clarity branded-queries update.

Quick answer: create a project at clarity.microsoft.com, install its tracking code using WordPress, Google Tag Manager or a manual snippet, verify that sessions appear, and use Heatmaps and Recordings to investigate a specific page. Connect Google Analytics 4 if you want acquisition metrics and behavior analysis in the same workflow.

For marketing teams, the goal is not to watch recordings for their own sake. It is to answer questions such as: Why do visitors click a button but not complete the form? Are mobile users missing the pricing section? Does a paid campaign bring visitors who reach the call to action?

What Is Microsoft Clarity and What Does It Do?

Microsoft Clarity helps website owners understand interactions that sit between a page view and a conversion. It is especially useful for investigating dead clicks, rage clicks, poor scroll reach, form friction and mobile usability issues. It reconstructs interactions from site activity so you can study clicks, scrolling and navigation patterns. Microsoft describes Clarity as a free service, with no paid upgrade required for its core offering. Its official overview lists recordings, heatmaps, funnels and AI-assisted insights.

Feature	What it helps you investigate	Example
Heatmaps	Where visitors click, scroll and spend time	Are people reaching a product comparison table?
Session recordings	How individual visits unfold	Where do visitors hesitate on a demo request?
Smart Events	Meaningful actions such as form submissions or downloads	Which visits contain a contact action?
Funnels	Drop-off across a defined sequence	How many sessions move from pricing to signup?
Traffic filters	Behavior by campaign, device, source or page	What do paid search visitors do after landing?

Clarity is not a substitute for a complete analytics or attribution setup. It can show that a visitor struggled with a form, but it cannot, on its own, confirm that a lead was qualified in your CRM or became revenue.

Microsoft Clarity vs Google Analytics 4: Which One Should You Use?

Use both when possible. GA4 describes acquisition and measured outcomes; Clarity helps explain what happened on the page. They answer related but different questions.

Question	Better starting point
How many sessions came from paid search?	GA4
Which campaign produced tracked demo requests?	GA4, followed by CRM validation
Did users click a non-clickable image?	Clarity click maps and recordings
Are mobile visitors missing the form?	Clarity scroll maps and recordings
Which channels generate qualified opportunities?	GA4 plus CRM and attribution reporting

For event troubleshooting, follow our GA4 DebugView tutorial. It covers checking whether measurement events actually fire before you use the numbers to assess campaign performance.

Before You Install Microsoft Clarity

You need access to the website and permission to install or manage its tracking. Decide whether you will use a WordPress plugin, GTM or a direct script. Use one installation method per Clarity project so the same tracking code is not accidentally loaded twice.

• Know the website URL and have a Microsoft Clarity account or a sign-in method accepted by Clarity.
• Have WordPress administrator access, GTM publishing access, or support from a developer, depending on the installation route.
• Review your cookie consent and privacy setup before adding tracking, especially if visitors come from Europe or the UK.
• Choose the production website you want to measure. Confirm whether staging and test environments should be excluded.
• Do not use Clarity on websites or apps targeting users under 18, in line with Microsoft’s published guidance.

Step 1: Create a Microsoft Clarity Project

1. Visit Microsoft Clarity and select Sign up or sign in.
2. From the Projects screen, select New project.
3. Enter a recognizable project name and your website URL, then create the project.
4. Open its Settings and Setup area to choose an installation method.
5. Keep the project ID and tracking method available. Each Clarity project has its own tracking code.

Microsoft allows multiple projects under an account. For most websites, start with one well-managed project for the production domain, and give the relevant people appropriate access instead of creating duplicate projects.

Step 2: Install Microsoft Clarity on Your Website

Choose the method that matches how you manage your website. The three routes below are alternatives, not steps you must all complete.

Option A: Install Microsoft Clarity on WordPress

This is the most straightforward route for a WordPress site that does not already manage Clarity through GTM.

1. In your WordPress dashboard, go to Plugins → Add New Plugin.
2. Search for Microsoft Clarity, install the official plugin, and activate it.
3. Open the Clarity entry in the WordPress navigation and choose Sign in.
4. Select an existing Clarity project or create a new project during setup.
5. Complete the connection and open your Clarity project to review the dashboard, heatmaps and recordings.

Microsoft’s WordPress installation guide covers the supported plugin setup. If a tracking tag is already running in GTM, do not add the plugin without first checking for duplication.

Option B: Install Clarity Through Google Tag Manager

For teams already managing analytics scripts in GTM, this keeps tracking changes within the existing tag governance process.

1. Open your Clarity project and go to Settings → Setup → Google Tag Manager.
2. Select Finish setup, sign into the Google account that manages your GTM container, and grant the requested permissions after reviewing them.
3. Select the correct GTM account and web container.
4. Choose Create and publish when you are ready to publish the tag.
5. Verify the tag on the live website and check that the Clarity project begins collecting data.

An alternative is GTM’s Community Template Library: create a tag, choose Microsoft Clarity – Official, enter your Clarity project ID, assign the correct page trigger and publish the container. Microsoft’s GTM setup documentation explains both routes.

Option C: Add the Clarity Tracking Code Manually

Use manual installation if a developer controls the site template or your website is not using a supported integration.

1. Open Settings → Setup in Clarity.
2. Under installation methods, select the manual installation option and copy the tracking code for your project.
3. Have your developer place the script in the site’s <head> on pages you intend to track.
4. Deploy the change and inspect a live page to confirm the script is present.
5. Return to Clarity and check that the project receives activity.

Do not place the tracking snippet in a single blog post if your goal is to analyze your entire website. Add it through a site-wide template or managed tag system, following your consent policy.

Step 3: Verify That Microsoft Clarity Is Working

A successful installation should begin collecting activity soon after the script loads. Microsoft’s setup guidance says you can start seeing data quickly, although dashboards, reports and individual views may not populate instantly. Verify the tag itself before treating an empty dashboard as an installation failure.

1. Open the live website in a test browser session that follows your normal consent process.
2. Visit several pages, click a navigation item and scroll down a longer page.
3. Confirm that the tracking code or GTM tag is loading as expected. In browser developer tools, inspect the Network panel for Clarity’s collect requests after your consent settings permit collection.
4. Open the correct Clarity project and look for live or recent activity, then review Recordings and Heatmaps as data becomes available.
5. If nothing appears after a reasonable wait, check the project ID, GTM container publishing status, content-security policy, browser extensions and consent signals. Also confirm you did not install Clarity twice using a plugin and GTM.

Common mistake: connecting GA4 to Clarity before installing the Clarity tracking code. The integration does not replace installation of Clarity itself.

How to Use Microsoft Clarity Heatmaps

Open Heatmaps, select a page or enter the relevant URL, choose the device and date range, and examine the available map types. For meaningful comparisons, keep device type, page variant and date range consistent. Clarity generates heatmaps from recorded interactions without requiring you to configure one for each page in advance.

Click Maps: See What Gets Attention

Click maps show which elements visitors interact with. Inspect the main call to action, navigation, pricing links, comparison sections and elements that look clickable but are not. Clarity also offers views for dead clicks, rage clicks, first clicks and last clicks.

Example: visitors repeatedly click an illustration beside a product feature because it looks like a button. That suggests a visual affordance problem. The solution may be to make the element interactive or adjust its appearance, not simply add another CTA.

Scroll Maps: Check Whether Important Sections Are Seen

Scroll maps show how far visitors reach down a page. Compare mobile and desktop rather than treating them as one audience. A form that is prominent on desktop may appear much farther down on a mobile layout.

Example: the strongest proof points and the demo form sit below sections that many visitors never reach. Test moving a concise proof statement and a useful CTA higher on the page. Then compare engagement and actual conversion performance.

Attention Maps: Find Where People Spend Time

Attention maps summarize the time visitors spend around page sections. High attention can signal interest, but it can also indicate confusion. Pair it with recordings before interpreting a long pause as a positive outcome.

Our guide to building high-converting landing pages explains how to turn these observations into better copy, page structure and forms.

How to Analyze Microsoft Clarity Session Recordings

In Recordings, select a session and use the playback controls and event timeline to review the visit. Clarity recordings reconstruct what happened using captured interactions; they are not ordinary screen videos taken from a visitor’s device.

Start with a question, not a random collection of recordings. For example, ‘Why are mobile users leaving the pricing page?’ Filter for mobile sessions that visited or exited that URL, then review several relevant journeys.

• Watch for repeated clicks, unexpected navigation and pauses immediately before an important action.
• Check whether the page layout, sticky elements or pop-ups obstruct content.
• Inspect how visitors interact with the form without expecting Clarity to reveal masked field values.
• Compare successful journeys with sessions that leave at the same step.
• Record a hypothesis and an improvement to test rather than treating one recording as representative of all users.

Microsoft documents a 30-day default retention window for recordings, followed by longer retention of a subset, so save your analysis and decisions outside the player. Avoid exporting personal or sensitive information.

How to Track Events and Conversions in Microsoft Clarity

Clarity supports Smart Events, which group meaningful interactions such as form submissions, signups, downloads and contact actions. It can identify some common event types automatically, and project administrators can define their own code-free events under Settings → Smart events.

Create a Smart Event for a Marketing Action

1. Open your project and go to Settings → Smart events → New event.
2. Choose an automatically identified event to customize or start from scratch.
3. Define the action with supported button click, page visit or other available event conditions.
4. Give it a clear name such as Demo Request Completed and save it.
5. Trigger the action on the website, then check that matching sessions and events appear as expected.

Be precise with definitions. A click on a ‘Request demo’ button is not automatically a valid demo submission. If the form displays validation errors, a button-click event may still fire. Use a successful completion action where available and validate lead records in your CRM and GA4.

Microsoft currently documents a limit of 20 user-created custom Smart Events per project and requires project-admin permissions to configure them.

Build a Funnel to Understand Drop-Off

A Clarity funnel is an ordered series of page visits or Smart Events. Treat each step as a specific tracked action, not an assumed business outcome. For a SaaS signup flow, you might compare visits to the pricing page, a signup action and an account-confirmation page. Configure the sequence in the project’s funnel settings, then inspect the sessions that leave at a particular step.

Funnels show where users stop progressing through the defined path. They do not, by themselves, explain why a person left or prove an eventual sale. Use recordings for behavioral context and CRM reporting for lead and revenue outcomes.

How to Connect Microsoft Clarity to Google Analytics 4

Once Clarity tracking is running, you can connect the project to Google Analytics to review GA data inside Clarity.

1. Open the Clarity project and go to Settings → Setup.
2. Find Google Analytics integration and select Get Started.
3. Sign in with the Google account that has access to the intended property.
4. Choose the correct web property and save.
5. Confirm that the integration is active and that the expected analytics data is accessible.

Microsoft’s Google Analytics integration guide notes that a project can connect to one web property. If manual configuration is needed, have the correct GA4 account, property and Measurement ID available.

For cleaner source and medium reporting, see our GA4 custom channel groups tutorial. You can also create consistent UTM parameters with OneMetrik’s free UTM Builder.

Three Practical Ways Marketers Can Use Clarity

Scenario	What to inspect in Clarity	Decision to test
Paid search landing page has clicks but few leads	Campaign-filtered mobile recordings, scroll depth and CTA clicks	Move key proof closer to the form; fix mobile layout friction
Organic tutorial receives traffic but little engagement	Scroll maps, attention maps and links receiving clicks	Improve introductory answer, section order and related-resource links
Visitors begin but do not finish a signup	Smart Events, funnel drop-off and selected recordings	Clarify requirements, remove unnecessary steps and test error messaging

For paid campaigns, review sessions using Clarity’s traffic filters for Source, Medium and Campaign. These work best when campaign URLs are tagged consistently. Review the observed issue against performance data before making creative or budget decisions.

If your campaign performance looks healthy but lead quality is poor, use our Google Ads audit checklist to investigate conversion tracking and campaign settings alongside landing-page behavior.

A Simple Clarity Review Workflow for Marketing Teams

A weekly review can be useful, but the output should be a short action log rather than an endless playlist of session recordings. Pick a page with enough relevant traffic to detect repeat behavior, and avoid making decisions from one unusual visitor journey.

1. Choose one business-critical page: a demo landing page, signup flow, product page or article with meaningful traffic.
2. Set a baseline: record its GA4 sessions, tracked conversions and relevant campaign or CRM metrics.
3. Inspect patterns: compare device-specific heatmaps, targeted recordings and any relevant Smart Events or funnel steps.
4. Write one testable hypothesis: ‘Visitors cannot find the demo form on mobile’ is more useful than ‘engagement is low.’
5. Make a controlled change: update the layout, copy or interaction and document the date.
6. Verify the result: compare the new behavior with actual conversions using an appropriate time period and, where possible, an A/B test.

Microsoft Clarity Not Working? Common Problems and Fixes

Problem	Likely checks
No data in the dashboard	Confirm the correct project ID, installed tag, live publishing status, consent state and time since installation.
Missing or incomplete recordings	Review consent, masking settings, browser restrictions and whether the session falls inside retention limits.
Heatmap looks different from the live page	Check device selection, responsive layout, dynamic elements and the page screenshot Clarity selected.
Form submission event is inaccurate	Check whether the event represents a click rather than confirmed success; validate against GA4 and CRM.
Paid campaign sessions cannot be isolated	Check utm_source, utm_medium and utm_campaign consistency.
Metrics differ from GA4	Review consent differences, tracking coverage, filtering and the fact that the two tools measure different things.

Microsoft Clarity Privacy, Consent and Data Limitations

Session analysis needs appropriate privacy controls. Microsoft masks sensitive content by default, including input field values, but you should still review the site’s masking rules and consent implementation before using recordings. Avoid embedding sensitive information in page elements that could be exposed by custom changes.

Since October 31, 2025, Microsoft has enforced consent signal requirements for visits originating in the European Economic Area, United Kingdom and Switzerland. For those regions, consent mode is enabled by default and Clarity should not set cookies until it receives the appropriate analytics-consent signal. Without that signal, Clarity may collect limited cookieless data, but full-session continuity and some behavioral features can be unavailable. Configure a supported consent-management platform, Google Consent Mode or the Clarity Consent API, and verify that declined consent does not set Clarity cookies. This does not replace your legal responsibility to obtain consent where required.

Review Microsoft’s consent management guidance and content masking documentation, especially before deploying on a site with forms or sensitive customer information. To test consent, decline tracking in a fresh browser session and confirm that _clck and _clsk cookies are not written.

Heatmaps also have technical limitations. Dynamic content, unusual scroll containers and snapshots of a page in different states may not appear exactly as visitors experienced them. Verify a suspicious pattern with recordings and your own device testing before treating it as a confirmed usability problem.

What to Do After Your First Clarity Review

Start with a page where improving the experience can affect a measurable business outcome. Pair Clarity’s behavioral evidence with GA4 events and CRM lead quality. That is more useful than optimizing a page simply because a heatmap has an interesting hot spot.

At OneMetrik, we use the same principle when evaluating marketing performance: visitor behavior helps explain friction, while reliable conversion and pipeline data tell us whether a change was worthwhile.

Frequently Asked Questions About Microsoft Clarity