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.
-
Open the project and select Speed Insights.
-
Select Enable.
-
Install the package in your app:
-
Add the component. For the Next.js App Router, add it to
app/layout.tsx:Other frameworks use
@vercel/speed-insights/react,@vercel/speed-insights/sveltekit,@vercel/speed-insights/vue, orinjectSpeedInsights()from@vercel/speed-insights. -
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.
| Metric | Measures | Great | Poor |
|---|---|---|---|
| Real Experience Score (RES) | A 0–100 score weighted from FCP (15%), LCP (30%), INP (30%), and CLS (25%) | Over 90 | Under 50 |
| First Contentful Paint (FCP) | When the first content appears | 1.8 s or less | Over 3 s |
| Largest Contentful Paint (LCP) | When the main content appears | 2.5 s or less | Over 4 s |
| Interaction to Next Paint (INP) | How quickly the page responds to input | 200 ms or less | Over 500 ms |
| Cumulative Layout Shift (CLS) | How much the layout moves while loading | 0.1 or less | Over 0.25 |
| Time to First Byte (TTFB) | When the first byte of the response arrives | 800 ms or less | Over 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.
| Plan | Included | After that |
|---|---|---|
| Hobby | 10,000 data points a month | Collection pauses until the next cycle. Your sites keep running. |
| Pro | 10,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
- Count visitors with Web Analytics.
- Find slow requests in Logs.