// 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
Share

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

  1. FIX 1Make assets publicly reachable

    1. 01Deploy CSS and fonts on a public URL
    2. 02Allow cross-origin access to them
    3. 03Allow requests with the header User-Agent: Clarity-Bot in your WAF/CDN
    Did this fix it?
  2. FIX 2Serve correct content types

    1. 01Check in DevTools that CSS returns text/css and fonts return font/woff2 (or matching type)
    Did this fix it?
  3. FIX 3Use versioned asset URLs

    1. 01Deploy updated CSS under a new file name or query version so cached styles match each recording
    Did this fix it?
  4. FIX 4Ask support to purge cached styles

    1. 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 us

Watch Microsoft Clarity Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Microsoft Clarity errors

All 12 Microsoft Clarity errors and fixes →