// troubleshooting guide · microsoft clarity
Microsoft Clarity Recordings Showing Broken Layout (No CSS)
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 17, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · microsoft-clarity/recordings-no-css4 FIXES
// quick answer
Clarity replays rebuild your page from the DOM and fetch your stylesheets and fonts from its servers. If those files are private, geo-blocked, temporary or served with the wrong content type, recordings show plain HTML. Make CSS publicly reachable and allow the Clarity-Bot user agent.
Most likely fix: Make assets publicly reachable
How to fix it
// try these in order, the most common fix is first
FIX 1Make assets publicly reachable
- 01Deploy CSS and fonts on a public URL
- 02Allow cross-origin access to them
- 03Allow requests with the header User-Agent: Clarity-Bot in your WAF/CDN
Did this fix it?FIX 2Serve correct content types
- 01Check in DevTools that CSS returns text/css and fonts return font/woff2 (or matching type)
Did this fix it?FIX 3Use versioned asset URLs
- 01Deploy updated CSS under a new file name or query version so cached styles match each recording
Did this fix it?FIX 4Ask support to purge cached styles
- 01Email clarityMS@microsoft.com with a recording link and the asset URLs that fail
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
Recordings or heatmaps show unstyled HTML, old styling, missing fonts, gray images or 'This part of the recording is unavailable'.
Why it happens
- C-01Stylesheets on localhost, staging, intranet or behind login
- C-02Firewall, geo or referrer rules blocking Clarity's servers
- C-03Temporary or expiring CSS/font URLs
- C-04Wrong MIME type on CSS or font files
- C-05Images and videos captured gray while the user was inactive
- C-06Content inside third-party iframes or canvas, which Clarity can't capture
// this guide also covers
- clarity recording no css
- microsoft clarity recording broken layout
- clarity recording blank screen
- this part of the recording is unavailable clarity
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 Tracking Code Not Detected
- Microsoft Clarity Heatmap Not Showing Data
- 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)