diff --git a/docs/02-app/01-building-your-application/02-data-fetching/01-fetching-caching-and-revalidating.mdx b/docs/02-app/01-building-your-application/02-data-fetching/01-fetching-caching-and-revalidating.mdx index f2bb2c610f9fe..23b9b1071dcb5 100644 --- a/docs/02-app/01-building-your-application/02-data-fetching/01-fetching-caching-and-revalidating.mdx +++ b/docs/02-app/01-building-your-application/02-data-fetching/01-fetching-caching-and-revalidating.mdx @@ -115,6 +115,8 @@ If you have multiple fetch requests in a statically rendered route, and each has Learn more about [time-based revalidation](/docs/app/building-your-application/caching#time-based-revalidation). +> **Good to know:** Revalidation only works with the [Node.js runtime](docs/app/building-your-application/rendering/edge-and-nodejs-runtimes#nodejs-runtime) (default). + #### On-demand Revalidation Data can be revalidated on-demand by path ([`revalidatePath`](/docs/app/api-reference/functions/revalidatePath)) or by cache tag ([`revalidateTag`](/docs/app/api-reference/functions/revalidateTag)) inside a Route Handler or a Server Action. diff --git a/docs/02-app/01-building-your-application/03-rendering/03-edge-and-nodejs-runtimes.mdx b/docs/02-app/01-building-your-application/03-rendering/03-edge-and-nodejs-runtimes.mdx index fdd358802ae3e..fe6dda871005d 100644 --- a/docs/02-app/01-building-your-application/03-rendering/03-edge-and-nodejs-runtimes.mdx +++ b/docs/02-app/01-building-your-application/03-rendering/03-edge-and-nodejs-runtimes.mdx @@ -27,6 +27,7 @@ There are many considerations to make when choosing a runtime. This table shows | Security | Normal | High | High | | Latency | Normal | Low | Lowest | | npm Packages | All | All | A smaller subset | +| Revalidation | Yes | Yes | No | ### Edge Runtime diff --git a/docs/02-app/02-api-reference/02-file-conventions/route-segment-config.mdx b/docs/02-app/02-api-reference/02-file-conventions/route-segment-config.mdx index 998af5976e976..449d27dbf57b8 100644 --- a/docs/02-app/02-api-reference/02-file-conventions/route-segment-config.mdx +++ b/docs/02-app/02-api-reference/02-file-conventions/route-segment-config.mdx @@ -118,6 +118,8 @@ export const revalidate = false - **`0`**: Ensure a layout or page is always [dynamically rendered](/docs/app/building-your-application/rendering/static-and-dynamic#dynamic-rendering) even if no dynamic functions or uncached data fetches are discovered. This option changes the default of `fetch` requests that do not set a `cache` option to `'no-store'` but leaves `fetch` requests that opt into `'force-cache'` or use a positive `revalidate` as is. - **`number`**: (in seconds) Set the default revalidation frequency of a layout or page to `n` seconds. +> **Good to know**: The `revalidate` option is only available when using the [Node.js Runtime](/https://nextjs.org/docs/app/building-your-application/rendering/edge-and-nodejs-runtimes#nodejs-runtime). This means using the `revalidate` option with `runtime = 'edge'` will not work. + #### Revalidation Frequency - The lowest `revalidate` across each layout and page of a single route will determine the revalidation frequency of the _entire_ route. This ensures that child pages are revalidated as frequently as their parent layouts.