Real User Metrics allows you to understand and prioritize the real-world experience of your site visitors.
With Real User Metrics, you can identify the production deploys that most impact your site’s usability and understand site performance based on Web Vitals that rely on real user interactions with your production site.
Real User Metrics surfaces the following Web Vitals based on real user interactions with your site.
|Web Vitals Metric||Measurement focus||Quick definition|
|Largest Contentful Paint (LCP)||Loading experience for largest assets||How quickly the page completely loads|
|Interaction to Next Paint (INP)||Responsiveness as the latency of a user’s click, tap, or keyboard interaction||How quickly the page responds to user interaction. Learn more about INP at the web.dev docs.|
|Cumulative Layout Shift (CLS)||Visual stability||How much the layout changes as a proxy for the visual stability of your site|
|First Contentful Paint (FCP)||Loading speed||How quickly the first parts of a page load|
These metrics are based on user-centric Web Vitals and include Core Web Vitals. Learn more about these metrics from web.dev.
INP will replace FID
The Core Web Vital metric First Input Delay (FID) will be deprecated in March 2024 from Core Web Vitals and replaced by Interaction to Next Paint (INP). Learn more in the web.dev docs.
# How Real User Metrics are collected
Real User Metrics collects user-centric Web Vitals based on real site vistor activity and aggregates this data for you along with production deploy details.
The impact to site performance is expected to be imperceptible to users with very little to no detected impact.
Once enabled, Real User Metrics does not require additional configuration or cookies on the client browser. Note that Ad blockers do not prevent real User Metrics from being collected.
Real User Metrics is best for busy sites with many visitors as it aggregates site visitor experiences. This avoids the subway effect, where one user on a subway who experiences a poor web experience doesn’t dramatically offset the results.
For a deeper understanding of your site performance, we recommend using Netlify’s analytics tools together. Here’s a quick overview of how these tools compare.
|Real User Metrics||Site Analytics||Lighthouse|
|Offers overview of site usability based on site visitor interactions and user-centric Web Vitals||Offers general overview of site usage, such as pageviews, number of unique visitors, top locations, etc. with adjustable time scales||Offers usability scores based on Web Vitals|
|Only for production site||Only for production site||Can apply to all site deploys|
|Gives insights after deploying to production||Gives insights after deploying to production||Gives insights before deploying to production and after|
|Most useful for high traffic sites||Useful for any site||Useful for any site|
|Offers real-world insights||Offers real-world insights||Offers insights based on synthetic testing|
# Enable Real User Metrics for your site
To enable Real User Metrics for your site:
- From your Site overview page, go to .
- Select Enable Real User Metrics.
After you enable Real User Metrics for your site, data collection will start the next time your site is visited.
Real User Metrics data is populated in your charts in one hour increments.
Be aware that your data will not populate until people first visit your site. So if no one visits your site, then your charts will stay empty with no data.
Data is not backfilled, and is collected on production deploys only.
If you turn off Real User Metrics for your site, you lose the metrics on your Real User Metrics dashboard. If you turn Real User Metrics back on, you must wait for new data to update your dashboard.
# Inspect a deploy on your chart
Expand details about a specific production deploy from your Real User Metrics Chart to understand how your deploy impacts the real-world experience of your site visitors.
To inspect a specific deploy from a chart:
Select a gray column (also called a deploy marker) in your chart. Once you select a deploy, the deploy description appears based on a pull/merge request or commit message.
To open the deploy details page for your selected deploy, select the deploy description text. The deploy details page offers a deploy summary and your deploy log.
# Review Real User Metrics for different sites
To quickly review Real User Metrics for different sites, use the site switcher next to your team name to change site data for your Real User Metrics dashboard.
Note that Real User Metrics must be enabled for each site individually.
# Filter your data
Find the specific events and performance metrics that matter most to you with the following filters:
- Device type
By default, Real User Metrics charts are scoped to the last 7 days.
To review your metrics in a more granular timeframe, you can click and drag your desired time frame in a Real User Metrics chart.
# Device types
By default, the Real User Metrics charts are scoped to an aggregate from all device types.
To understand how your site performs on different device types, use the device filter above your charts to scope data to mobile or desktop devices.
By default, the Real User Metrics charts will display scores for the 75th, 95th, and 99th percentiles of all of your site’s page loads. You can expand details for the minimum, average, and maximum metric results.
To focus on the percentiles that matter most to you, choose which percentiles to feature in all of your site’s Real User Metrics charts. To set your chart percentiles, select one or more percentiles at the bottom of any chart.
# Understand your scores
Each Real User Metrics category (LCP, CLS, INP, FID, FCP) has a score range for acceptable performance.
To help you quickly gauge your site’s performance, we apply score status badges to each chart using Good, Mid, Poor, or Needs improvement.
When calculating the overall status of LCP, CLS, INP, FID, FCP for your production site, Netlify only considers metrics within the 75th percentile of all of your production site’s page loads.
|Score category||Good range||Mid range||Poor range|
|Largest Contentful Paint (LCP)||< 2500 ms||2500 - 4000 ms||> 4000 ms|
|Cumulative Layout Shift (CLS)||< 0.1||0.1 - 0.25||> 0.25|
|Interaction to Next Paint (INP)||< 200 ms||200 - 500 ms||> 500 ms|
|First Input Delay (FID)||< 100 ms||100 - 300 ms||> 300 ms|
|First Contentful Paint (FCP)||< 1800 ms||1800 - 3000 ms||> 3000 ms|
How is the layout shift score calculated?
The layout shift score is calculated using this formula:
Layout shift score = impact fraction x distance fraction.
# Improve your scores and your site’s user experience
Improve the user-centric Real User Metrics for your site by checking out these guidelines from web.dev.
# Content Security Policy support
If your site is using a Content Security Policy (CSP), you must add
script-src netlify-rum.netlify.app to your CSP rule in your
netlify.toml file to ensure Real User Metrics can run for your site.
/* Content-Security-Policy: [...] script-src https://netlify-rum.netlify.app
[[headers]] for = "/*" [headers.values] Content-Security-Policy = "[...] script-src https://netlify-rum.netlify.app"
Learn more about using the Content Security Policy.
# Troubleshoot Real User Metrics
If you are not finding any Real User Metrics data for a site, consider the following:
- Does your site have a Content Security Policy (CSP)? If so, you’ll need to make an update to your CSP configuration.
- Does your site get very little traffic? If so, be aware that your data will not populate until people first visit your site.
# Disable Real User Metrics
Once disabled, Real User Metrics charts for your site will no longer be available.
If you decide to turn Real User Metrics back on, you need to wait for new Real User Metrics data since your charts will not backfill data.
To disable the Real User Metrics service for a site, go to. At the bottom of the page, select Disable Real User Metrics.
Did you find this doc useful?
Your feedback helps us improve our docs.