Skip to content

Rule · Performance

Render-blocking resources delay first paint

perf/render-blockingwarnvoid perfupdated

Why it matters

Synchronous scripts in <head> and large stylesheets stop the browser from painting until they are fetched and executed.

How to fix it

Add defer or type="module" to scripts, load third-party tags async/lazily, and keep blocking CSS small.

Example

tsx
<script src="/app.js" defer></script>

void perf reports 25 rules in this category. Core Web Vitals and bytes: LCP, CLS, TBT, TTFB, JavaScript, CSS, fonts, images, caching and compression, measured as the median of several runs on a throttled mobile and a desktop profile.