staleTimes

staleTimes is an experimental feature that enables caching of page segments in the Client Cache.

You can enable this experimental feature and provide custom revalidation times by setting the experimental staleTimes flag:

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}
 
module.exports = nextConfig

The static and dynamic properties correspond with the time period (in seconds) based on different types of link prefetching.

• The dynamic property is used when the page is neither statically generated nor fully prefetched (e.g. with prefetch={true}).
  • Default: 0 seconds (not cached)
• The static property is used for statically generated pages, or when the prefetch prop on Link is set to true, or when calling router.prefetch.
  • Default: 5 minutes

Version History