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.Image Optimization pricing is dependent on your plan and how many unique source images you have across your projects during your billing period.
Image Optimization on the Pro trial plan is free for the first 2500 source images.
Plan | Image Optimization Limit | Price (after limit hit) |
---|---|---|
Pro Trial | 2500 source images | N/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.
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 thealt
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.
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.
Was this helpful?