It's essential for the continued success of your application to understand how users are experiencing it: Does it load fast? Is it responsive? Is it visually stable?

Vercel makes this process easy by collecting metrics from your user's devices and calculating a Real Experience Score for you – which reflects how well your application is performing in the wild.

With the Analytics view, you gain insight into the score and the individual metrics without having to modify your code or leave the dashboard.

Note: It's recommended, but Analytics doesn't require hosting your application on Vercel.

An example of the Analytics tab on the project view.

Enabling the Feature

Analytics are disabled by default, but can be enabled on a per-project basis by navigating to the Analytics tab of any project in your dashboard.

From there, you will then be prompted to enable the feature and take different actions depending on whether your application is hosted on Vercel or not.

Supported Frameworks

Next.js (v10+)

Vercel Analytics supports Next.js 10+ with zero-configuration required. Projects on Next.js 9 or earlier are required to upgrade to enable Vercel Analytics.

Nuxt.js (v2+)

Vercel automatically configures and adds @nuxtjs/web-vitals to the buildModules section of your nuxt.config.js file. You do not need to add this plugin manually. Once redeployed, your application will automatically send vitals to Vercel Analytics.

Gatsby (v2+)

Vercel automatically configures and adds gatsby-plugin-vercel to your gatsby-config.js file. You do not need to add this plugin manually. Once redeployed, your application will automatically send vitals to Vercel Analytics.

Hosted on Vercel

If your application is being deployed to Vercel, enabling the Analytics feature is only a matter of navigating to the Analytics tab of the project and confirming that you'd like to enable it in the prompt that shows.

Afterward, you will be offered to redeploy your current Production Deployment to apply the automatic data point tracking to the client-side bundle of your application.

Once you've enabled the feature and redeployed your Production Deployment, data points will appear within 30 minutes, depending on the traffic your project receives. Preview deployments will also collect analytics when enabled.

Self-Hosted

If your application isn't being deployed to Vercel, you can still use Analytics.

To get started, create a new Project from a template. Afterward, navigate to the Domains page in the project settings and remove the only remaining domain.

You can then navigate to the Analytics tab of the project and you'll be presented with a configuration property that you need to place in your config file.

Once you've configured the property, enable the feature and wait for the data points to appear.

Note: You can only use Analytics with an application that's hosted elsewhere if you're using the Pro or Enterprise plan.

Content Security Policy

When collecting data points for every visit of your application, the Analytics feature will send requests directly from the visitor's browser to Vercel's servers, where the data points are then processed and stored.

If you've configured a Content Security Policy in your application, you therefore need to make sure that the Domain vitals.vercel-insights.com is allowed for outgoing requests (as described in this section, the client-side bundle will report Analytics via network requests).

Pricing

Depending on your pricing plan, different fees apply:

Hobby
Pro
Enterprise
Base Fee per Project per Month
None
$10 USD
Custom
Fee per 10,000 Data Points (Hosted on Vercel)
None
$0.65 USD
Custom
Free Data Points per Day
100
100
Custom

If you're using Analytics on the Pro plan while on a trial, you will not be charged for any of the above items during the time of the trial.

Only once the trial ends, you will be charged for the data points collected during the trial and the base fee.

Prorating

When enabling Analytics, you will immediately be charged the base fee mentioned above. However, you will only be charged for the remaining time in your billing cycle. For example, if there are 10 days remaining in your current billing cycle, that's roughly 30% of your billing cycle – so you will only pay about $3 USD. For every new billing cycle after that, you will be charged the full $10 USD in the beginning of the cycle.

After canceling Analytics, it will continue to show data points that were already collected until the end of the current billing cycle (however, no new data will be recorded). You won't be refunded any amounts already paid. Once the billing cycle is over, Analytics will automatically turn off and you will lose access to existing data.

If you decide to re-enable the feature after having canceled it, you won't be charged at the time of enabling it. Instead, you will normally be charged the $10 USD in the beginning of every upcoming billing cycle.

Limits

Once you've enabled Analytics, different limitations are applied depending on your plan:

Hobby
Pro
Enterprise
Sample Rate
100%
100%
Custom
Reporting Window for Data Points
1 Day
7 Days
28 Days
Maximum Number of Data Points per Month
10,000
None
None

To use a larger reporting window and unlock more data points per day, make sure to deploy your project to a Vercel Team on the Pro plan.

For an even larger reporting window and even more data points, please reach out to our Sales team for a custom Enterprise plan.

Note: On the Hobby plan, Analytics can only be enabled on a single Vercel project. Analytics is only available on the Hobby, Pro, and Enterprise plans.

Sample Rate

By default, all incoming data points are used to calculate the scores you're being presented with on the Analytics view.

To reduce cost, you can change the sample rate in the Billing section of your Team settings. It is possible to change the percentage at which the data points will be collected to reduce the total amount of collected data. Additionally, a spend limit can be provided to ensure no more data points are collected for the rest of the billing period once the limit has been reached.

Analytics Sampling settings.

Reporting Window for Data Points

If the Analytics feature is enabled for a project on a Personal Account, you can only see the last 24 hours of data points.

For Teams on the Pro plan, you can choose between the last 24 hours, the last 3 days, and the last 7 days.

Lastly, for Teams on the Enterprise plan, the same options as for Teams on the Pro plan are offered – plus the last 14 or 28 days.

Maximum Number of Data Points per Day

Depending on your plan, a maximum limit of data points might apply per day (as mentioned in the table above). Once that limit is reached, no more data points will be recorded until the current day has passed. On the next day, the recording will resume.

During the time that recording is paused, you can still access all existing data points.