Revalidation Basics

This page perfoms a fetch on the server to get a random article from Wikipedia. The fetched data is then cached with a tag named "randomWiki" and a maximum age of 60 seconds.

const url = 'https://en.wikipedia.org/api/rest_v1/page/random/summary';

async function RandomArticleComponent() {
const randomArticle = await fetch(url, {
next: { revalidate: 60, tags: ['randomWiki'] }
});
// ...render
}

After the set time has passed, the first request for this page would trigger its rebuild in the background. When the new page is ready, subsequent requests would return the new page - see stale-white-revalidate.

Alternatively, if the cache tag is explicitly invalidated by revalidateTag('randomWiki'), any page using that tag would be rebuilt in the background when requested.

In real-life applications, tags are typically invalidated when data has changed in an external system (e.g., the CMS notifies the site about content changes via a webhook), or after a data mutation made through the site.

For this functionality to work, Next.js uses the fine-grained caching headers available on Netlify - but you can use these features on basically any Netlify site!

A5758 road
Road in Merseyside, England

The A5758 road is a 2.2-mile (3.5 km) single-carriageway road in Merseyside, England, constructed during 2014–15 and linking the A565 road in Thornton to Switch Island junction. The road is [...]

From Wikipedia