Microsoft Clarity
TrueMetriks adds free Microsoft Clarity session recordings and heatmaps to your site through the tracker you already installed. Here is how to set it up.
Set this up with AI
Copy this prompt into ChatGPT, Claude or whichever AI you use. It carries this whole guide, the pages it depends on, and a link to every video, so it can walk you through it one step at a time.
What you need
A Microsoft Clarity account with a project for this website. Clarity is free at clarity.microsoft.com - sign in with a Microsoft, Google, or Facebook account and create a project that points at your site's URL. Each project has a short Project ID, which is the only thing you paste into TrueMetriks.
Connect Microsoft Clarity to TrueMetriks
Step 1 - Open Settings
In TrueMetriks, pick the site you want from the selector at the top of the left sidebar, then click Settings at the bottom of the sidebar.
Step 2 - Open the Microsoft Clarity tile
Click the Integrations tab, then click the Microsoft Clarity tile.
Integrations
Connect third-party data sources to fire events into TrueMetriks.
Typeform
Connected
Calendly
Connected
Microsoft Clarity
Not configured
Stripe
Connected
Whop
Connected
Step 3 - Copy your Clarity Project ID
In Clarity at clarity.microsoft.com, open your project and go to its Settings. The Project ID sits at the top of the Overview - click the copy icon next to it. It is a short string like qz8mn4k2p.
Overview
Project ID: qz8mn4k2p
Name
Website URL
The Project ID is also the trailing part of your Clarity tag URL: in Settings -> Setup the install snippet loads https://www.clarity.ms/tag/<PROJECT_ID> - the bit after /tag/ is the same ID.
Step 4 - Paste the ID and save
Back in TrueMetriks, paste the ID into Clarity Project ID, leave Tag Clarity sessions with TrueMetriks event names ticked, and click Save. The tile now reads Configured.
← Back to Integrations
Microsoft Clarity
Free session replay tool. We inject Clarity's loader on every page of your site. Sessions appear in your Clarity dashboard at clarity.microsoft.com. You can configure more than one project below.
Find it in Clarity → Settings → Setup. It is the trailing segment of the https://www.clarity.ms/tag/<PROJECT_ID> URL.
Clarity starts loading on every page on the next visit, and recordings appear in your Clarity dashboard within a few minutes.
Tag Clarity sessions with TrueMetriks event names
This is the checkbox under the Project ID. Leave it on (the default) and each recording is labelled with the TrueMetriks event that fired, so in Clarity you can filter recordings by that tag and jump straight to, say, every session that ended in a Purchase. The tag uses the same event names you see on the Events page and the standard conversion events from your Facebook and other integrations.
Jump from a page's scroll depth into Clarity
The Scroll depth panel on a page's detail view carries a Clarity column once Clarity is connected. Click it on any row to open Replays, Click map, or Scroll map for that page in Clarity.
The three links carry the page and the date range across - they are not filtered by scroll depth, so every row on the panel opens the same page-scoped view. Clarity has no way to filter by a depth TrueMetriks measured, which is also why the number of recordings you see in Clarity will not match the panel's Visitors column: Clarity samples its recordings rather than keeping one for every visitor.
Scroll depth itself comes from the TrueMetriks page tracker, not from Clarity. The Shopify Web Pixel does not measure it, so a store tracked only through the Web Pixel has no scroll depth to open from.
Load more than one project
A single site can feed more than one Clarity project. Click + Add project, paste another Project ID, and Save - TrueMetriks loads every project you list on each page, and each keeps its own Tag sessions toggle. This is useful when two teams keep separate Clarity workspaces, or when you are migrating from an old project to a new one and want both recording for a while. To remove a project, clear its ID (or use the trash icon when more than one row is shown) and Save.
Where your recordings show up
Recordings and heatmaps live in Clarity, not in TrueMetriks. Open clarity.microsoft.com, pick this project, and you will see the session list, recordings, and heatmaps there. Or jump straight there from a page's Scroll depth panel, filtered to that page and, when Clarity can express it, your date range. A range Clarity cannot express, such as one that ends in the past, opens on Clarity's own default range.
If sessions are not showing up
- Give it a few minutes. Clarity batches recordings; the first sessions can take a little while to appear after you save the Project ID.
- Confirm the TrueMetriks tracker is live on the page. Clarity rides your TrueMetriks tracker, so if a page is not sending visits to TrueMetriks it will not load Clarity either. Check that the page shows up in your TrueMetriks visits first, and see the install guide if it does not.
- Check the Project ID. It is the short string after
/tag/in the Clarity snippet - no spaces, no full URL. Re-copy it from Clarity's Overview and Save again. - Confirm the project is for this site in Clarity (the Website URL on the Overview screen should match), or recordings will land in the wrong project.
Frequently asked questions
Do I still need to paste Clarity's tracking tag on my site?
No. You paste only your Clarity Project ID into TrueMetriks, and we inject Clarity's loader on every page through the tracker you already installed. If you can see visits in TrueMetriks, Clarity will load.
What does tagging Clarity sessions with event names do?
When on, every time a TrueMetriks event fires during a session it is stamped onto the live Clarity recording. You can then filter recordings in Clarity by that tag and jump straight to, say, every session that ended in a Purchase.
Where do the recordings and heatmaps show up?
In Clarity at clarity.microsoft.com, not in TrueMetriks. TrueMetriks only loads Clarity and tags the sessions; the playback UI is Clarity's own.
Do I need Clarity to see scroll depth?
No. Scroll depth is measured by the TrueMetriks page tracker and shows whether or not Clarity is connected. The one exception is a Shopify store tracked only through the Shopify Web Pixel, which does not measure scroll depth. Connecting Clarity adds a column of links that open the matching recordings, click map or scroll map.