// troubleshooting guide · microsoft clarity
Microsoft Clarity Tracking Code Not Detected
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 17, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · microsoft-clarity/tracking-code-not-detected4 FIXES
// quick answer
If Clarity says the tag isn't installed or no data arrives, the snippet is usually pasted in the wrong place, belongs to a different project, or isn't published yet. Copy the code again from Settings > Setup, put it in the <head>, and confirm POST requests to clarity.ms/collect.
Most likely fix: Re-copy the correct snippet
How to fix it
// try these in order, the most common fix is first
FIX 1Re-copy the correct snippet
- 01Open Projects and select the project
- 02Go to Settings > Setup > Install manually and copy the code
- 03Compare the src/project ID with the script in your site's <head>
- 04Replace it if it differs; paste directly, not via a word processor
Did this fix it?FIX 2Use a platform integration instead
- 01In Settings > Setup, select View all platforms
- 02Pick WordPress, Shopify, Wix, Squarespace or Google Tag Manager and follow the steps
- 03For GTM: choose account and container, then Create and publish
Did this fix it?FIX 3Clear caches and script delays
- 01Purge your CDN and caching plugin
- 02Exclude clarity.ms from 'delay JavaScript' or 'combine JS' options
- 03Reload and check DevTools > Network for 'collect'
Did this fix it?FIX 4Install on every subdomain and template
- 01Add the same project script to each subdomain and page you want tracked
- 02Recheck after theme or template changes
Did this fix it?
SANDBOX · microsoft-clarity RUNS IN YOUR BROWSER
Try it: browse a sample shop and watch visitors, funnels and live data arrive
A hands-on Microsoft Clarity-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Setup still asks you to install the code, the dashboard shows no data hours after install, or you see another site's pages in your project.
Why it happens
- C-01Code pasted in the body, a footer widget or through a text editor that altered characters
- C-02Snippet from a different Clarity project (wrong project ID in src)
- C-03GTM tag created but container not published
- C-04Caching or optimization plugins serving old HTML or delaying scripts
- C-05Script missing on subdomains or some templates
// this guide also covers
- clarity tracking code not detected
- microsoft clarity not installed
- clarity not collecting data
- verify microsoft clarity installation
Still not working?
If Microsoft Clarity keeps failing, you're not alone. See every Microsoft Clarity problem users report or the alternatives people switch to.
Done fighting Microsoft Clarity? Our small team builds your own Microsoft Clarity alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usOther Microsoft Clarity errors
- Microsoft Clarity Not Recording Sessions
- Microsoft Clarity Heatmap Not Showing Data
- Microsoft Clarity Recordings Showing Broken Layout (No CSS)
- Microsoft Clarity Consent Mode Not Working
- Microsoft Clarity Creating a New Session on Every Page
- Microsoft Clarity GA4 Integration Not Working
- Microsoft Clarity Not Working on Shopify
- Microsoft Clarity Recordings Showing Asterisks (Masked Text)