# Unlighthouse > Google Lighthouse for your entire site. Canonical Origin: https://unlighthouse.dev ## LLM Resources - [Full Content](https://unlighthouse.dev/llms-full.txt) Complete page content in markdown format. - [sitemap.xml](/sitemap.xml) XML sitemap for search engines and crawlers. - [robots.txt](/robots.txt) Crawler rules and permissions. ## Pages - /: Google Lighthouse for your entire site. - /integration-deprecations: Build tool integrations are deprecated in v1.0. Learn about migration paths and alternatives. - /releases: Google Lighthouse for your entire site. - /glossary: Definitions and explanations of Core Web Vitals, Lighthouse metrics, and web performance terminology. - /glossary/cls: CLS measures visual stability. Learn what it is, thresholds, and how to prevent layout shifts. - /glossary/fcp: FCP measures when the first content renders. Learn what it is, thresholds, and how to improve it. - /glossary/index: Definitions and explanations of Core Web Vitals, Lighthouse metrics, and web performance terminology. - /glossary/inp: INP measures responsiveness. Learn what it is, thresholds, and how to improve interaction speed. - /glossary/lcp: LCP measures loading performance. Learn what it is, thresholds, and how to improve your score. - /glossary/speed-index: Speed Index (SI) measures how fast visible content fills the viewport. Good: ≤3.4s mobile, ≤1.3s desktop. 10% of Lighthouse performance score. Thresholds, tools... - /glossary/tbt: TBT measures main thread blocking during load. Learn what it is, thresholds, and how to reduce blocking time. - /glossary/ttfb: TTFB measures server response time. Learn what it is, thresholds, and how to optimize it. - /glossary/tti: TTI measured page interactivity but was deprecated in Lighthouse 10. Learn what replaced it. - /guide/getting-started/how-it-works: Learn how Unlighthouse automatically discovers pages, runs Lighthouse audits in parallel, and generates site-wide performance reports. - /guide/getting-started/installation: Install and run Unlighthouse CLI to scan your entire website with Lighthouse. npm, pnpm, and yarn installation options. - /guide/getting-started/integrations: Integrate Unlighthouse into your existing build tools, frameworks, and CI/CD pipelines for automated Lighthouse testing. - /guide/guides/authentication: Scan password-protected websites with Unlighthouse. Configure basic auth, cookies, headers, localStorage, and programmatic login flows. - /guide/guides/chrome-dependency: Configure Chrome browser settings for Unlighthouse scanning, including system Chrome usage and custom installations. - /guide/guides/common-errors: Troubleshoot common issues encountered when running Unlighthouse scans, including browser connection and environment problems. - /guide/guides/config: Configure Unlighthouse for your specific needs using configuration files and inline options. - /guide/guides/debugging: Debug and troubleshoot Unlighthouse scans using logging, browser inspection, and diagnostic tools. - /guide/guides/device: Run Unlighthouse in desktop mode with the --desktop flag: npx unlighthouse --site --desktop. Configure mobile, desktop, or custom viewports with throttlin... - /guide/guides/docker: Run Unlighthouse site-wide Lighthouse scans in Docker containers. Dockerfile examples and CI/CD configuration. - /guide/guides/dynamic-sampling: Automatically sample similar pages to reduce scan time for sites with many similar URLs like blogs or e-commerce. - /guide/guides/generating-static-reports: Generate static Lighthouse reports for your entire site. Export as HTML, CSV, or JSON. Deploy to Netlify, CloudFlare, or any static host. - /guide/guides/lighthouse: Customize Google Lighthouse audit settings, categories, and performance thresholds within Unlighthouse scans. - /guide/guides/puppeteer: Configure Puppeteer launch options in Unlighthouse: headless mode, Chrome args, viewport settings, executable path, and navigation hooks. - /guide/guides/route-definitions: Configure route discovery and custom sampling patterns for better page organization and intelligent scanning. - /guide/guides/url-discovery: How Unlighthouse discovers pages using sitemaps, robots.txt, and internal link crawling. Configure URL sources and filters. - /guide/recipes/client: Modify Unlighthouse client interface columns and display to show custom metrics and data. - /guide/recipes/improving-accuracy: Optimize Lighthouse scan accuracy with multiple samples and reduced concurrency for more reliable, consistent Core Web Vitals results. - /guide/recipes/large-sites: Scan large websites with thousands of pages efficiently. Configure sampling, URL filtering, and optimization strategies for bulk Lighthouse testing. - /guide/recipes/spa: Configure Unlighthouse to scan single-page applications (SPAs) with client-side routing like React, Vue, and Angular apps. - /integrations/ci: Run unlighthouse-ci on every deploy. Auto-discovers every URL, runs Lighthouse on all of them in parallel, enforces a single budget. Works in GitHub Actions, Gi... - /integrations/cli: Scan your entire website with Lighthouse from the command line. Alternative to lighthouse CLI that audits all pages automatically. - /integrations/nuxt: Integrate Lighthouse audits directly into your Nuxt development workflow with automatic route discovery. - /integrations/vite: Integrate Lighthouse audits into your Vite development server with automatic route discovery and HMR support. - /integrations/webpack: Add Lighthouse auditing to webpack-based projects with development server integration and HMR support. - /learn-lighthouse: Free guides to improve Lighthouse scores and Core Web Vitals. Fix LCP, CLS, INP, accessibility, and SEO audits with actionable tutorials and tools. - /learn-lighthouse/bulk-lighthouse-testing: Run Lighthouse on your entire site with Unlighthouse. Limit pages with --maxRoutes, filter by URL pattern, and automate bulk audits. - /learn-lighthouse/core-web-vitals: Master Core Web Vitals - Google's page experience metrics. Learn LCP, CLS, INP thresholds, how to measure them, and fixes that improve rankings and conversions. - /learn-lighthouse/lhci-vs-unlighthouse: Honest side-by-side comparison of @lhci/cli and Unlighthouse. Setup, URL discovery, budgets, reporting, and when each tool fits your workflow. - /learn-lighthouse/pagespeed-insights-vs-lighthouse: Why your Lighthouse score differs from PageSpeed Insights. Understand lab vs field data, scoring differences, and when to use each tool. - /learn-lighthouse/accessibility: Master web accessibility with Lighthouse. Learn how accessibility audits work, why they matter for users and SEO, and how to fix common issues. - /learn-lighthouse/accessibility/aria-hidden-focus: Learn how to fix aria-hidden-focus issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/aria-required-attr: Learn how to fix aria-required-attr issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/aria-valid-attr: Learn how to fix aria-valid-attr issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/button-name: Learn how to fix buttons without accessible names in Lighthouse accessibility audits. - /learn-lighthouse/accessibility/bypass: Fix bypass issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/color-contrast: Learn how to fix color contrast issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/document-title: Learn how to fix missing document title in Lighthouse accessibility audits. The title gives screen reader users an overview of the page. - /learn-lighthouse/accessibility/frame-title: Learn how to fix frame and iframe title issues in Lighthouse accessibility audits - /learn-lighthouse/accessibility/heading-order: Fix heading order issues in Lighthouse accessibility audits. Ordered headings convey semantic structure for easier navigation. - /learn-lighthouse/accessibility/html-has-lang: Learn how to fix missing lang attribute in Lighthouse accessibility audits. The lang attribute helps screen readers pronounce content correctly. - /learn-lighthouse/accessibility/image-alt: Learn how to fix missing image alt attributes in Lighthouse accessibility audits - /learn-lighthouse/accessibility/label: Learn how to fix missing form labels in Lighthouse accessibility audits. Labels ensure form controls are announced properly by assistive technologies. - /learn-lighthouse/accessibility/link-name: Fix links without discernible names in Lighthouse accessibility audits - /learn-lighthouse/accessibility/meta-viewport: Fix 'zooming and scaling must not be disabled' Lighthouse audit. Remove user-scalable=no and maximum-scale=1 from your viewport meta tag. - /learn-lighthouse/accessibility/tabindex: Fix tabindex values greater than zero in Lighthouse accessibility audits - /learn-lighthouse/accessibility/target-size: Fix touch target size issues in Lighthouse accessibility audits - /learn-lighthouse/best-practices: Master Lighthouse Best Practices audits. Learn what they measure, why they matter for security and UX, and how to pass every audit. - /learn-lighthouse/best-practices/bf-cache: Make back button navigation instant with bfcache. Learn common blockers and how to fix them. - /learn-lighthouse/best-practices/charset: Properly declare character encoding to prevent text rendering issues and security vulnerabilities. - /learn-lighthouse/best-practices/deprecations: Replace deprecated browser APIs before they are removed. Covers document.domain, Event.path, keyCode, and sync XHR. - /learn-lighthouse/best-practices/doctype: Learn why your page needs a proper HTML doctype and how quirks mode breaks your layout and CSS. - /learn-lighthouse/best-practices/errors-in-console: Identify and resolve browser console errors. Clean up JavaScript exceptions, failed network requests, and deprecation warnings affecting your site. - /learn-lighthouse/best-practices/geolocation-on-start: Stop requesting geolocation permission on page load. Users distrust sites that ask for location without context - tie requests to user actions instead. - /learn-lighthouse/best-practices/image-aspect-ratio: Display images with their natural aspect ratio to prevent distortion. Stretched or squished images look unprofessional. - /learn-lighthouse/best-practices/image-size-responsive: Serve images with appropriate resolution for the display size and device pixel ratio. Blurry images hurt perceived quality. - /learn-lighthouse/best-practices/inspector-issues: Resolve browser-detected problems including mixed content, cookie issues, CSP violations, and cross-origin blocks that appear in Chrome's Issues panel. - /learn-lighthouse/best-practices/is-on-https: Eliminate insecure HTTP requests and mixed content warnings. Learn to enforce HTTPS across your entire site for security and modern web features. - /learn-lighthouse/best-practices/notification-on-start: Stop requesting notification permission on page load. Users dismiss these prompts reflexively - wait for a user action that shows they want notifications. - /learn-lighthouse/best-practices/paste-preventing-inputs: Stop preventing users from pasting into input fields. Blocking paste breaks password managers and frustrates users without improving security. - /learn-lighthouse/best-practices/redirects-http: Configure your server to redirect all HTTP traffic to HTTPS. Protect users and enable secure web features across your entire site. - /learn-lighthouse/cls: Google considers a CLS score of 0.1 or less as good. Learn what causes layout shifts and how to fix CLS with proven techniques for images, fonts, ads, and dynam... - /learn-lighthouse/cls/ads-embeds-iframes: Prevent layout shifts from third-party ads, video embeds, social widgets, and iframes with reserved space techniques. - /learn-lighthouse/cls/animations-transitions: Eliminate CLS from animations by using compositor-friendly properties like transform and opacity instead of layout-triggering properties. - /learn-lighthouse/cls/dynamic-content-injection: Stop cookie banners, notifications, and lazy-loaded content from causing layout shifts with space reservation and transforms. - /learn-lighthouse/cls/layout-shifts: Diagnose and fix layout shifts caused by CSS reflow, font-size changes, unsized media, web fonts, and injected iframes. Reduce your CLS score. - /learn-lighthouse/cls/unsized-images: Images without width and height cause layout shifts. Add explicit dimensions to prevent your page from jumping around as images load. - /learn-lighthouse/cls/web-fonts-causing-foit: How to prevent layout shifts from web font loading using font-display, preloading, and fallback metrics. - /learn-lighthouse/inp: Master INP optimization with practical fixes for JavaScript execution, DOM operations, and event handlers. Improve responsiveness across your site. - /learn-lighthouse/inp/dom-size: Large DOMs slow every interaction. Reduce DOM size with virtualization, lazy rendering, and smarter component architecture. - /learn-lighthouse/inp/event-handler-delays: Slow event handlers directly hurt INP. Optimize click, input, and keypress handlers for instant feedback. - /learn-lighthouse/inp/heavy-dom-operations: Reduce main thread work from DOM manipulation, style recalculation, and layout thrashing. Keep interactions responsive. - /learn-lighthouse/inp/hydration-issues: Framework hydration blocks interactivity. Delay and partial hydration strategies to make SSR sites responsive faster. - /learn-lighthouse/inp/long-running-javascript: Reduce JavaScript execution time to improve INP. Learn code splitting, web workers, and task chunking to keep the main thread responsive. - /learn-lighthouse/inp/third-party-scripts: Third-party scripts compete for main thread time. Learn to defer, facade, and limit their impact on interaction responsiveness. - /learn-lighthouse/inp/total-blocking-time: Reduce TBT to improve your Lighthouse performance score. TBT measures main thread blocking - the lab proxy for real-world INP. - /learn-lighthouse/lcp: LCP measures when the main content loads. Good score: ≤2.5s mobile. Fix slow LCP with image optimization, TTFB improvements, and render-blocking resource remova... - /learn-lighthouse/lcp/best-practices-2026: The 2026 LCP playbook: Priority Hints, Speculation Rules, 103 Early Hints, Lighthouse 13 Insights, View Transitions, AVIF, HTTP/3, and edge streaming SSR. - /learn-lighthouse/lcp/client-side-rendering: How to improve LCP by using server-side rendering or pre-rendering instead of client-side rendering. - /learn-lighthouse/lcp/large-images: Optimize LCP images with responsive srcset, modern formats like WebP and AVIF, and proper compression. Reduce image size without losing quality. - /learn-lighthouse/lcp/lazy-loading-above-fold: Why you should never lazy-load your LCP image and how to fix it. - /learn-lighthouse/lcp/lcp-lazy-loaded: Remove loading='lazy' from hero images. Lazy-loading your LCP image adds 500ms+ delay. Fix with eager loading and fetchpriority='high'. - /learn-lighthouse/lcp/prioritize-lcp-image: Add fetchpriority='high' and preload your LCP image. 85% of sites miss this — one attribute can cut LCP by 100-400ms. - /learn-lighthouse/lcp/redirects: Eliminate redirect chains that delay LCP. Learn to identify and fix 301/302 redirects, canonical URL issues, and trailing slash mismatches. - /learn-lighthouse/lcp/render-blocking-resources: How to eliminate render-blocking CSS and JavaScript in the Lighthouse audit. Async/defer scripts, critical CSS extraction, font loading, and Next.js optimizeCss... - /learn-lighthouse/lcp/resource-load-delay: How to reduce resource load delay by preloading LCP resources and prioritizing critical assets. - /learn-lighthouse/lcp/slow-server-response: Reduce server response time to improve LCP. Learn CDN setup, caching strategies, database optimization, and edge computing solutions. - /learn-lighthouse/lcp/total-byte-weight: How to reduce total page weight and avoid enormous network payloads that slow down your Largest Contentful Paint. - /learn-lighthouse/lcp/unminified-javascript: How to minify JavaScript files to reduce payload sizes, improve parse time, and accelerate your Largest Contentful Paint. - /learn-lighthouse/lcp/unused-javascript: How to reduce unused JavaScript through code splitting, tree shaking, and dynamic imports to improve your Largest Contentful Paint. - /learn-lighthouse/lighthouse-ci: Complete guide to Lighthouse CI (@lhci/cli) from Google. Automate Lighthouse audits in CI/CD, enforce performance budgets, prevent regressions. Install, configu... - /learn-lighthouse/lighthouse-ci/budgets: Set and enforce performance budgets with Lighthouse CI. Configure assertions, presets, custom thresholds, and budget.json to prevent regressions in CI/CD. - /learn-lighthouse/lighthouse-ci/configuration: Complete guide to lighthouserc.js configuration options. Covers collect, assert, upload, and server settings for @lhci/cli. - /learn-lighthouse/lighthouse-ci/github-actions: Complete Lighthouse CI GitHub Actions documentation. Step-by-step YAML workflows, status checks, PR comments, and treosh/lighthouse-ci-action setup. - /learn-lighthouse/lighthouse-ci/gitlab-ci: Configure Lighthouse CI for GitLab pipelines. Includes .gitlab-ci.yml examples, merge request integration, and artifact storage. - /learn-lighthouse/lighthouse-ci/server: Deploy your own Lighthouse CI server for historical tracking, build comparisons, and team dashboards. Covers Docker, Heroku, and database setup. - /learn-lighthouse/lighthouse-ci/troubleshooting: Fix common Lighthouse CI issues: Chrome launch failures, score variance, shallow clone errors, upload problems, and more. - /learn-lighthouse/pagespeed-insights-api: Complete guide to using the PageSpeed Insights API. Get Lighthouse performance data programmatically with 25,000 free requests per day. - /learn-lighthouse/pagespeed-insights-api/bulk-testing: Test multiple URLs with the PageSpeed Insights API. Queue implementation, rate limit handling, and practical limits of bulk PSI testing. - /learn-lighthouse/pagespeed-insights-api/get-api-key: Step-by-step guide to getting a free PageSpeed Insights API key from Google Cloud Console. Setup takes 2 minutes. - /learn-lighthouse/pagespeed-insights-api/node-example: Fetch Lighthouse data with Node.js using the googleapis.com/pagespeedonline/v5/runPagespeed endpoint. Working TypeScript code examples. - /learn-lighthouse/pagespeed-insights-api/python-example: Fetch Lighthouse data with Python using the googleapis.com/pagespeedonline/v5/runPagespeed endpoint. Working code examples with type hints. - /learn-lighthouse/pagespeed-insights-api/rate-limits: Handle PSI API quotas without breaking your integration. Rate limit detection, retry strategies, and quota monitoring. - /learn-lighthouse/playwright: Run Google Lighthouse audits with Playwright for automated performance, accessibility, and SEO testing. Complete setup guide with code examples. - /learn-lighthouse/playwright/authentication: Run Lighthouse audits on pages behind login. Learn how to preserve authentication state when Lighthouse opens a new browser context. - /learn-lighthouse/playwright/ci-cd: Automate Lighthouse audits with Playwright in GitHub Actions. Run performance tests on every PR with thresholds and artifact reports. - /learn-lighthouse/playwright/troubleshooting: Fix common issues when running Lighthouse with Playwright: port conflicts, authentication problems, flaky scores, and Chrome version mismatches. - /learn-lighthouse/seo: Pass every Lighthouse SEO audit. Crawlability, canonical, meta description, robots.txt, hreflang, status codes — each check explained with fixes and examples. - /learn-lighthouse/seo/canonical: Resolve canonical tag errors that cause duplicate content issues and diluted page authority. Learn to implement rel=canonical correctly. - /learn-lighthouse/seo/crawlable-anchors: Learn how to fix anchor elements that search engines can't follow due to missing or invalid href attributes. - /learn-lighthouse/seo/hreflang: Learn how to fix hreflang validation errors including unexpected language codes and relative URLs in your multi-language site. - /learn-lighthouse/seo/http-status-code: Fix pages returning 4xx or 5xx HTTP status codes that prevent proper indexing. Learn status code meanings, common causes, and how to resolve server errors. - /learn-lighthouse/seo/is-crawlable: Remove crawl blocks preventing search engines from indexing your pages. Fix robots.txt, meta robots, and X-Robots-Tag issues. - /learn-lighthouse/seo/link-text: Learn how to replace generic link text like "click here" with descriptive text that helps search engines understand your content. - /learn-lighthouse/seo/meta-description: Add compelling meta descriptions to improve click-through rates from search results. Learn how to write effective descriptions that drive traffic. - /learn-lighthouse/seo/robots-txt: Fix robots.txt validation errors that prevent search engines from properly crawling your site. Learn syntax rules, common errors, and proper configuration. - /tools: Free bulk Core Web Vitals checker, Lighthouse score calculator, CLS debugger, LCP finder, and more. Test multiple pages at once with no signup. - /tools/bulk-pagespeed: Free bulk Core Web Vitals and PageSpeed test. Check LCP, CLS, INP for up to 10 URLs at once. Get Lighthouse scores and CWV pass/fail for multiple pages. - /tools/cls-debugger: Free CLS testing tool. Enter a URL to find which elements cause Cumulative Layout Shift and get actionable fixes. No signup required. - /tools/cwv-checker: Check if your page passes Google's Core Web Vitals. Test LCP, CLS, and INP with lab and real user data. Free tool with actionable recommendations. - /tools/cwv-compare: Bulk test and compare Core Web Vitals across multiple websites. See how your LCP, CLS, and INP stack up against competitors with real Chrome user data. - /tools/cwv-history: Free CrUX history viewer. Track 25 weeks of LCP, CLS, and INP trends from real Chrome users. Monitor Core Web Vitals changes over time. - /tools/har-viewer: Free HAR file viewer and network analyzer. Upload HAR files to visualize waterfall charts, request timing, resource breakdown, and protocol analysis. Entirely c... - /tools/inp-analyzer: Free INP testing tool. Analyze your Interaction to Next Paint score, find long tasks blocking the main thread, and improve responsiveness. - /tools/json-size: Free JSON size calculator. Measure raw, minified, gzip, and brotli sizes. Analyze key contributions, depth, and duplicate key overhead. Paste JSON, get instant ... - /tools/lcp-finder: Free LCP test tool. Find your Largest Contentful Paint element, see timing breakdowns, and get actionable recommendations to improve loading speed. - /tools/lighthouse-report-viewer: Free Lighthouse JSON viewer and report analyzer. Upload or paste Lighthouse JSON to view scores, Core Web Vitals, and audit details. Works with PageSpeed Insigh... - /tools/lighthouse-score-calculator: Free interactive Lighthouse scoring calculator. See how FCP, LCP, TBT, CLS, and Speed Index weights and thresholds determine your Lighthouse performance score. ... - /tools/page-size: Free page size checker. Analyze total page weight, resource breakdown by type, third-party script weight, unused code, and compression efficiency. Compare again... - /tools/pagespeed-insights-performance: Comprehensive PageSpeed Insights performance report with Core Web Vitals, resource analysis, third-party breakdown, and actionable recommendations. - /tools/ttfb-checker: Free TTFB test tool. Check your server response time with real Chrome user data (CrUX). Compare field vs lab TTFB and track trends over time.