Skip to main content
Observe

Speed Insights

Measure Core Web Vitals from real visitors with the unmodified @vercel/speed-insights package.

Speed Insights measures how fast your site is for the people using it. Your visitors' browsers report Core Web Vitals, and Easel shows them per route, path, and country, with a Real Experience Score that sums them up. It works with the @vercel/speed-insights package as it is.

Turn it on

Speed Insights is off until a workspace owner or admin turns it on for a project.

  1. Open the project and select Speed Insights.

  2. Select Enable.

  3. Install the package in your app:

    npm i @vercel/speed-insights
  4. Add the component. For the Next.js App Router, add it to app/layout.tsx:

    import { SpeedInsights } from "@vercel/speed-insights/next";
    
    // in <body>, after {children}:
    <SpeedInsights />

    Other frameworks use @vercel/speed-insights/react, @vercel/speed-insights/sveltekit, @vercel/speed-insights/vue, or injectSpeedInsights() from @vercel/speed-insights.

  5. Deploy, then visit a few pages. A page reports its metrics when the visitor leaves it or navigates away.

Every build points the package at a path unique to your project instead of /_vercel/speed-insights, so ad blockers don't drop your metrics.

To turn it off, open Settings > Analytics.

Metrics

Each metric is rated against the Core Web Vitals thresholds.

MetricMeasuresGreatPoor
Real Experience Score (RES)A 0–100 score weighted from FCP (15%), LCP (30%), INP (30%), and CLS (25%)Over 90Under 50
First Contentful Paint (FCP)When the first content appears1.8 s or lessOver 3 s
Largest Contentful Paint (LCP)When the main content appears2.5 s or lessOver 4 s
Interaction to Next Paint (INP)How quickly the page responds to input200 ms or lessOver 500 ms
Cumulative Layout Shift (CLS)How much the layout moves while loading0.1 or lessOver 0.25
Time to First Byte (TTFB)When the first byte of the response arrives800 ms or lessOver 1.8 s

Read the page

Pick Desktop or Mobile, an environment, and a time range at the top of the page. Select a metric on the left to chart it at the 75th, 90th, 95th, or 99th percentile. The dashed lines on the chart are the metric's thresholds.

Below the chart, routes, paths, and countries are sorted into Poor, Needs Improvement, and Great. Select one to filter the page by it.

To collect fewer data points, set sampleRate on the component, for example <SpeedInsights sampleRate={0.5} />.

Pricing

A data point is one metric from one page view.

PlanIncludedAfter that
Hobby10,000 data points a monthCollection pauses until the next cycle. Your sites keep running.
Pro10,000 data points a month$0.65 per 10,000 data points

Your project's firewall rules and rate limits apply to Speed Insights requests, so you can block or limit traffic that would add data points you don't want.

Next steps