Analysis

Performance

Available since v3.1.0

Performance tracks real-user Core Web Vitals collected directly from your visitors' browsers. Use it to identify slow pages, spot regressions over time, and compare performance across devices and browsers.

Use Cases#

  • Identify slow-loading pages that may be hurting user experience or SEO rankings.
  • Compare Core Web Vitals across different devices, browsers, and regions.
  • Validate the impact of performance improvements over time.

Usage#

Add the data-performance attribute to your tracking script to enable automatic collection of Core Web Vitals.

Once enabled, Umami will automatically capture performance metrics from your visitors' browsers and report them under the Performance tab for that website.

If you are tracking pageviews manually, keep auto-track enabled and add data-auto-pageview="false" instead of data-auto-track="false". This manual pageview setup requires v3.2.0 or later.

Metrics#

MetricDescription
LCPLargest Contentful Paint — time until the largest visible element is rendered.
INPInteraction to Next Paint — responsiveness of the page to user interactions.
CLSCumulative Layout Shift — visual stability; lower is better.
FCPFirst Contentful Paint — time until the first content is rendered on screen.
TTFBTime to First Byte — time from request to first byte received from the server.

Thresholds#

Each metric is rated against Google's defined thresholds:

MetricGoodNeeds ImprovementPoor
LCP< 2,500 ms2,500 – 4,000 ms> 4,000 ms
INP< 200 ms200 – 500 ms> 500 ms
CLS< 0.10.1 – 0.25> 0.25
FCP< 1,800 ms1,800 – 3,000 ms> 3,000 ms
TTFB< 800 ms800 – 1,800 ms> 1,800 ms

Percentiles#

Results are displayed at three percentile levels:

PercentileDescription
p50Median — half of users experience this or better.
p7575th percentile — the value most users experience. Google uses this for Core Web Vitals scoring.
p9595th percentile — represents the worst-case experience for most users.

Viewing Performance#

Navigate to a website and click the Performance tab.

Select a metric card to focus the chart on that metric. Use the Percentile dropdown to switch between p50, p75, and p95.

Pages and Environment breakdowns#

The bottom of the page shows the selected metric broken down by Pages (path or title) and Environment (device or browser), helping you pinpoint which pages or clients are underperforming.