Microsoft Clarity

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.

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.

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.

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.

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.

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.