Reference

Limits and Pricing for Image Optimization

This page outlines information on the limits that are applicable to using Image Optimization, and the costs they can incur.
Table of Contents

Image Optimization pricing is dependent on your plan and how many unique source images you have across your projects during your billing period.

Managed Infrastructure hobby and pro resources
Resource
Hobby Included
Pro Included
Pro Extra
First 1,000First 5,000$5.00 - 1,000 Images

Image Optimization on the Pro trial plan is free for the first 2500 source images.

PlanImage Optimization LimitPrice (after limit hit)
Pro Trial2500 source imagesN/A

The table below shows the metrics for the Image Optimization section of the Usage dashboard.

To view information on managing each resource, select the resource link in the Metric column. To jump straight to guidance on optimization, select the corresponding resource link in the Optimize column.

Manage and Optimize pricing
Metric
Description
Priced
Optimize
Source imagesThe number of images that have been optimized using the Image Optimization featureYesLearn More

Usage is not incurred until an image is requested. Learn more about managing costs for Image Optimization.

A source image is the value that is passed to the src prop. A single source image can produce multiple optimized images. For example:

  • Usage: <Image src="/hero.png" width="700" height="745" />
  • Source image: /hero.png
  • Optimized image: /_next/image?url=%2Fhero.png&w=750&q=75
  • Optimized image: /_next/image?url=%2Fhero.png&w=828&q=75
  • Optimized image: /_next/image?url=%2Fhero.png&w=1080&q=75

For example, if you are on a Pro plan and have passed 6000 source images to the src prop within the last billing cycle, your bill will be $5 for image optimization.

You are billed for the number of unique source images requested during the billing period.

Additionally, charges apply for Fast Data Transfer when optimized images are delivered from Vercel's Edge Network to clients.

Image Optimization is free for Hobby users within the usage limits. As stated in the Fair Usage Policy, Hobby teams are restricted to non-commercial personal use only.

Vercel will send you emails as you are nearing your usage limits, but you will also be advised of any alerts within the dashboard.

Once you exceed the limits:

  • New source images will fail to optimize and instead return a runtime error response with 402 status code. This will trigger the onError callback and show the alt text instead of the image
  • Previously optimized images have already been cached and will continue to work as expected, without error

You will not be charged for exceeding the usage limits, but this usually means your application is ready to upgrade to a Pro plan.

Get started with Vercel Pro for free

Experience the power of Pro features during your trial. Unlock unlimited Serverless Function requests, 1000 GB-hours of execution, boosted application bandwidth, and enjoy free access to Speed Insights throughout your trial period.

If you want to continue using Hobby, read more about Managing Usage & Costs to see how you can disable Image Optimization per image or per project.

For Teams on Pro trials, the trial will end if your Team uses over 2500 source images. For more information, see the trial limits.

Vercel will send you emails as you are nearing your usage limits, but you will also be advised of any alerts within the dashboard. Once your team exceeds the 5000 source images limit, you will continue to be charged $5 per 1000 source images for on-demand usage.

Pro teams can set up Spend Management to get notified or to automatically take action, such as using a webhook or pausing your projects when your usage hits a set spend amount.

For all the images that are optimized by Vercel, the following limits apply:

  • The maximum size for an optimized image is 10 MB, as set out in the Cacheable Responses limits. If this limit is exceeded, a 500 status code will be returned
  • Each source image has a maximum width and height of 8192 pixels
  • A source image must be one of the following formats to be optimized: .jpeg, .png, .webp. Other formats will be served as-is

See the Fair Usage Policy for typical monthly usage guidelines.

Last updated on October 3, 2024