Incremental Static Regeneration usage and pricing
This page outlines information on the limits that are applicable to using Incremental Static Regeneration (ISR), and the costs they can incur.Vercel offers several methods for caching data within Vercel’s managed infrastructure. Incremental Static Regeneration (ISR) caches your data at the edge and persists it to durable storage – data reads and writes from durable storage will incur costs.
ISR Reads and Writes are priced regionally based on the location of the request. See the regional pricing documentation for more information.
The table below shows the metrics for the ISR 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. The cost for each metric is based on the request location, see the pricing section and choose the region from the dropdown for specific information.
There is no limit on storage for ISR, all the data you write remains cached for the duration you specify. Only you or your team can invalidate this cache—unless it goes unaccessed for 31 days.
The total amount of Write Units used to durably store new ISR data, measured in 8KB units.
The total amount of Read Units used to access the ISR data, measured in 8KB units.
ISR reads and writes are measured in 8 KB units:
- Read unit: One read unit equals 8 KB of data read from the ISR cache
- Write unit: One write unit equals 8 KB of data written to the ISR cache
ISR Reads and Writes are priced regionally based on the location of the request. See the regional pricing documentation for more information.
You are charged based on the volume of data read from and written to the ISR cache, and the regions where reads and writes occur. To optimize ISR usage, consider the following strategies.
- For content that rarely changes, set a longer time-based revalidation interval
- If you have events that trigger data updates, use on-demand revalidation
When attempting to perform a revalidation, if the content has no changes from the previous version, no ISR write units will be incurred. This applies to be time-based ISR as well as on-demand revalidation.
If you are seeing writes, this is because the content has changed. Here's how you can debug unexpected writes:
- Ensure you're not using
new Date()
in the ISR output - Ensure you're not using
Math.random()
in the ISR output - Ensure any other code which produces a non-deterministic output is not included in the ISR output
You get charged based on the amount of data read from your ISR cache and the region(s) in which the reads happen.
When viewing your ISR read units chart, you can group by:
- Projects: To see the number of read units for each project
- Region: To see the number of read units for each region
You get charged based on the amount of ISR write units written to your ISR cache and the region(s) in which the writes happen.
When viewing your ISR writes chart, you can group by sum of units to see a total of all writes across your team's projects.
- Projects: To see the number of write units for each project
- Region: To see the number of write units for each region
Was this helpful?