SiteBrief/Documentation

Core Web Vitals & PageSpeed

Automatic daily monitoring of all 6 Core Web Vitals for mobile and desktop. Track trends, catch regressions, and share Google audit links with clients.

How it works

SiteBrief uses the Google PageSpeed Insights API to run a full Lighthouse audit on your site every day at 3:00 AM. Results are stored for both mobile and desktop strategies, so you can track performance trends over time.

To enable it: go to the site detail page → Settings → turn on Core Web Vitals monitoring. The first results appear after the next daily check, or you can trigger it manually via the cron API.

ℹ️
Note:Each check stores all 6 metrics for both strategies. Data is retained for 90 days, giving you a long-term view of performance.

What gets measured

MetricAbbrWhat it measuresGood threshold
Largest Contentful PaintLCPTime until the largest visible element loads< 2.5s
Cumulative Layout ShiftCLSHow much page elements move unexpectedly during load< 0.1
Interaction to Next PaintINPResponse time to clicks, taps, and keyboard input< 200ms
First Contentful PaintFCPTime until any content first appears on screen< 1.8s
Time to First ByteTTFBHow fast the server responds to the first request< 800ms
Total Blocking TimeTBTTotal time JavaScript blocks the main thread during load< 200ms
💡
Tip:LCP, CLS, and INPare Google's official Core Web Vitals — confirmed ranking factors. FCP, TTFB, and TBT are diagnostic metrics that explain why LCP or INP might be poor.

Score ranges

ScoreRatingWhat it means
90–100🟢 GoodFast site. All or most Core Web Vitals are in the Good range.
50–89🟡 Needs improvementSome performance issues. Worth investigating.
0–49🔴 PoorSerious problems. Likely affecting SEO and user retention.

Mobile vs Desktop

SiteBrief checks both strategies. Google uses mobile-first indexing — mobile scores are what affect SEO rankings. Desktop scores are typically 10–20 points higher and are useful for comparing the experience across device types.

Use the Mobile / Desktop toggle on the site detail page to switch between the two views.

14-day trends

Each metric card shows a sparkline of the last 14 checks. The color reflects the current rating: green for Good, amber for Needs improvement, red for Poor. A downward trend (lower values) is good for time-based metrics (LCP, FCP, TTFB, INP, TBT) and for CLS.

If you see a sudden spike in LCP overnight, it usually means a large image was uploaded, a plugin was updated, or the server is under load.

View audit link

Any metric that is not in the Good range shows a View audit → link. Clicking it opens Google PageSpeed Insights with a full Lighthouse report for that URL and strategy — with specific, actionable recommendations from Google.

This is useful when a client asks "why is my score low?" — send them the audit link directly instead of trying to explain it yourself.

In client reports

The PDF report includes a full Core Web Vitals section on page 2: performance score gauge, all 6 metrics with Good/Needs improvement/Poor ratings, and security status. The report is generated with the latest stored data — run a manual check before sending if you want fresh results.

Low CWV scores are a natural upsell opportunity — the data gives you a concrete, Google-backed reason to discuss a performance optimization engagement with the client.

Common reasons for low scores

  • Large unoptimized images (LCP) — use WebP, compress, add explicit dimensions, preload the hero image.
  • Render-blocking resources (FCP, TBT) — defer non-critical JS, inline critical CSS.
  • Slow server response (TTFB) — add server-side caching, use a CDN, or upgrade hosting.
  • Layout shifts (CLS) — images without width/height, late-loading ads, web fonts causing FOUT.
  • Heavy JavaScript (TBT, INP) — code-split, lazy-load, remove unused plugins.
  • No CDN — serving from a single origin far from the user. A CDN can cut TTFB and LCP dramatically.

Frequently asked questions

The score in SiteBrief differs from what I see in PageSpeed Insights — why?
PageSpeed scores vary by ±5–10 points between runs because real network conditions and server load change. SiteBrief always tests from Google's infrastructure with a standard Lighthouse mobile configuration. Significant differences are usually due to caching — if you tested manually right after visiting the site, the cache was warm.
How often does SiteBrief check Core Web Vitals?
Once per day at 3:00 AM, for both mobile and desktop. This gives you a consistent daily data point without burning through API quota. Data is retained for 90 days.
The score dropped from 85 to 60 overnight — what happened?
Common causes: a plugin auto-update added heavy JS, a new image was uploaded without compression, Google's Lighthouse updated its scoring algorithm, or the server was slow at check time. Use the "View audit" link to open the full Google report and see which specific metrics changed.
Does the PageSpeed score directly affect Google rankings?
LCP, INP, and CLS are confirmed Google ranking signals. The overall Lighthouse performance score is not directly a ranking signal, but it correlates closely with the metrics that are. A score of 90+ almost always means all Core Web Vitals are in the Good range.
Can I trigger a check manually?
Yes — call the cron endpoint with your CRON_SECRET header: curl -H "Authorization: Bearer YOUR_SECRET" https://yourdomain.com/api/cron/check-cwv. This will check all sites with Core Web Vitals monitoring enabled.