How-to

Using Speed Insights

Learn how to use Speed Insights to analyze your application's performance data.
Table of Contents

To access Speed Insights:

  1. Select a project from your dashboard and navigate to the Speed Insights tab.
  2. Select the timeframe and environment you want to view data for.
  3. Use the panels to filter the page or event data you want to view.

Speed Insights offers a variety of views to help you analyze your application's performance data. This allows you to identify areas that need improvement and make informed decisions about how to optimize your site.

To view metrics for a specific route or path:

  1. Select a project from your dashboard and navigate to the Speed Insights tab.
  2. From the left-hand panel, select the metric you want to view data for.
  3. From the URL view, select the corresponding tab to view by the Route (the actual pages you built), or by Path (the URLs requested by the visitor).
  4. The information is organized by performance score and sorted by data points. Scroll the list to view more all paths or routes, or click the View all button to view and filter all data.
  5. You can also edit the timeframe and environment you want to view data for.
Speed Insights URL view for routes and paths of your project.
Speed Insights URL view for routes and paths of your project.

To view a detailed breakdown of the performance of individual HTML elements on your site:

  1. Select a project from your dashboard and navigate to the Speed Insights tab.
  2. From the left-hand panel, select the metric you want to view data for. HTML element attribution is only available for the following metrics:
    • Interaction to Next Paint (INP)
    • First Input Delay (FID)
    • Cumulative Layout Shift (CLS)
    • Largest Contentful Paint (LCP)
  3. From the URL view, select the Selectors tab.
  4. The information is organized by performance score and sorted by data points. Scroll the list to view more all elements, or click the View all button to view and filter all data.
  5. You can also edit the timeframe and environment you want to view data for.

This view is particularly useful for identifying specific elements that may be causing performance issues.

This view is helpful for identifying regions where your application may be underperforming.

To view a geographical breakdown of your application's performance:

  1. Select a project from your dashboard and navigate to the Speed Insights tab.
  2. From the left-hand panel, select the metric you want to view data for.
  3. Scroll down to the Countries section.
  4. The map is colored based on the experience metric per country. Click on a country to view more detailed data.
Geographic map of the P75 score where the color intensity indicates the relative amount of data points per country
Geographic map of the P75 score where the color intensity indicates the relative amount of data points per country

You may want to disable Speed Insights in your project if you find you no longer need it. You can disable Speed Insights from within the project settings in the Vercel dashboard. If you are unsure if a project has Speed Insights enabled, see Identifying if Speed Insights is enabled.

If you transfer a project with Speed Insights enabled from a Hobby team to a Pro plan, it will continue to be enabled but with increased limits, as documented in the pricing docs . This means that Speed Insights will be added to your Pro plan invoice automatically.

  1. Select a project from your dashboard .
  2. Navigate to the Speed Insights tab.
  3. Click on the ellipsis on the top-right of the Speed Insights page and select Disable Speed Insights.
Disable Speed Insights option.
Disable Speed Insights option.

When you disable Speed Insights in the middle of your billing cycle, it will not be removed instantly. Instead it will stop collecting new data points but will continue to show already collected data until the end of the cycle, see the prorating docs for more information.

If you are on an Enterprise plan, check your contract entitlements as you may have custom limits included. If you have any questions about your billing/contract regarding Speed Insights you can reach out to your CSM or AE for further clarification.

If you have many projects on your Vercel account and are not sure which of them has Speed Insights enabled, you can see this from the dashboard without needing to check each project separately. The different circles in the right corner of each project card will show the Speed Insights status.

If Speed Insights is not enabled, then the circle will be gray, with the speed insights logo. For example:

Speed Insights not enabled for a project.
Speed Insights not enabled for a project.

If Speed Insights is enabled but no data points have been collected yet then it will show an empty circle, like the below:

Speed Insights enabled for a project but no data points have been collected.
Speed Insights enabled for a project but no data points have been collected.

If Speed Insights is enabled and data points have been collected then the circle will be coloured with a number inside, similar to the below image:

Speed Insights enabled for a project and has data points.
Speed Insights enabled for a project and has data points.
Last updated on November 21, 2024