Lighthouse is moving to performance insight audits

Published: April 28, 2025

Over a year ago, we announced our intention to evolve our performance tooling including bringing "the power of Lighthouse, in[to] the Performance panel". The intent was to bring our many performance tooling surfaces together.

On the Performance Panel side, we have made great progress on that goal, and the Insights sidebar now provides Lighthouse-like information that works with the trace. As part of this work, we have made a number of changes to the performance advice that Lighthouse users are familiar with: in some cases advice from many audits is consolidated into a single insight, and we have retired some advice.

Staying with our aim to consolidate our tooling surfaces, we want to bring those Insights back to Lighthouse. Both for consistency, and also so that Lighthouse users can benefit from the improvements we've made to these audits—plus any future improvements!

Unfortunately this does mean some breaking changes for Lighthouse users, especially the API users that may be used to certain audit names or result formats. For this reason we will wait for the next major release of Lighthouse (13) before we make this switch—which we're aiming for in October 2025. After this time, the old audit data will no longer be available.

Renamed and consolidated audits

The following audits have been renamed and in some cases are consolidated from more than one Lighthouse audit:

New insight audit id Replacing audit id(s)
cls-culprits-insight layout-shifts
non-composited-animations
unsized-images
document-latency-insight redirects
server-response-time
uses-text-compression
dom-size-insight dom-size
duplicated-javascript-insight duplicated-javascript
font-display-insight font-display
image-delivery-insight modern-image-formats
uses-optimized-images
efficient-animated-content
uses-responsive-images
interaction-to-next-paint-insight work-during-interaction
lcp-discovery-insight prioritize-lcp-image
lcp-lazy-loaded
lcp-phases-insight largest-contentful-paint-element
legacy-javascript-insight legacy-javascript
modern-http-insight uses-http2
network-dependency-tree-insight critical-request-chains
uses-rel-preconnect
render-blocking-insight render-blocking-resources
third-parties-insight third-party-summary
use-cache-insight uses-long-cache-ttl
viewport-insight viewport
Renamed and consolidated audits

Removed audits

The following audits have been removed as it was felt these no longer served useful purposes:

Removed audits Reason for removal
first-meaningful-paint Older metric that is no longer recommended (replaced by LCP)
no-document-write Rarely an issue in first-party scripts these days, and it is inactionable for third-party scripts that use this.
offscreen-images Offscreen images are already deprioritized by the browser so while lazy loading helps reduce bandwidth, it is unlikely to have an impact on what Lighthouse measures.
uses-passive-event-listeners Rarely an issue in first-party scripts these days, and it is inactionable for third-party scripts that use this.
uses-rel-preload Not enabled due to risks of over recommending.
third-party-facades This audit covers limited facades and some developers expressed concern using non-affiliated third-party facades. Ultimately, we would prefer the third-parties improve their offerings rather than work around them.
Removed audits

Other audits

The other Performance audits not included in the previous tables won't be affected by this change. Similarly, the audits for Accessibility, SEO, and Best Practices also won't be affected by this change.

Migrate to the new insights audits

To facilitate the migration, we've already made the new insights available in the Lighthouse JSON. Consumers of the API and the Lighthouse JSON can start migrating now to prepare for the eventual removal of the old audits in Lighthouse 13.

Lighthouse 12.6 (included in Chrome 137) will also show a visible toggle to allow users of the report to toggle between the two different views:

Trying insights in Lighthouse.

The new insights-based audits will show under an Insights heading, while the unchanged audits will continue to show under a Diagnostics heading.

At the moment, the default is to continue to show the old audits, but in a June 2025 Lighthouse release (likely 12.7), we plan to switch the default to the newer insights audits. This change will also be rolled out to PageSpeed Insights and DevTools Lighthouse reports in Chrome 139. Users will still be able to toggle back to the old audits for a limited period of time until Lighthouse 13.

Documentation for the new insights audits

We'll be documenting the new audits on developer.chrome.com before the cutover date. The old documentation will be kept around for the foreseeable future so prior versions of Lighthouse can still link to them.

Feedback

If you have any concerns or questions on this move, then we'd love to hear them on this GitHub discussion.