Services

Fix Stale Content, Webhook and Revalidation Issues in Headless CMS and Next.js Stacks

Content is published in the CMS, but webhooks, caches, and route invalidation no longer agree, leaving changes fresh in one place and stale in another.

Fix content not updating from your CMS before stale pages and revalidation failures stop editors trusting what the live site is actually showing.

Short Answer

Stale content in a headless CMS and Next.js stack usually means webhooks, caches, route dependencies, and revalidation rules no longer line up. Editors lose trust quickly when published changes are fresh in one place and stale in another. Diagnosis should follow one controlled content change through the full freshness path until the failing step is clear.

Typical Symptoms

  • Published content is not appearing on the site when editors expect it to.
  • Webhooks fire but the front end remains stale or partially updated.
  • Different routes refresh at different times or not at all.

Likely Causes

  • Webhook triggers, route invalidation, and cache layers are not aligned.
  • The system does not clearly distinguish preview freshness from published freshness.
  • Revalidation is happening, but not for the routes or dependencies that matter.

What I Look at First

  • Publish one controlled content change and trace the webhook, cache, and route freshness path end to end.
  • Which content changes fail first and whether the failure is deterministic.
  • How freshness behaviour differs between preview and published routes.

How I Help Fix This

  • Trace the stalecontent problem across the actual invalidation chain.
  • Tackle the routes and content types with the clearest commercial impact first.
  • Make freshness more predictable and testable.

When to Look at This

  • When stale content is eroding editorial or commercial trust in the platform.
  • When revalidation exists on paper but behaves differently by route, environment, or content type.

What Gets Resolved

  • Cache, webhook, tag, ISR, preview, and production freshness paths are traced until stale content behaviour is explained.
  • Preview, publishing, route, and cache behaviour are made explicit.
  • Content modelling risks are separated from rendering and template faults.
  • Editor workflow stability and SEOcritical output are checked together.
  • Fixes are prioritised by publishing confidence and delivery risk.

How This Usually Works

  1. Technical Diagnostic

    A focused review of affected routes, templates, deployment behaviour, crawl signals, CMS behaviour, performance bottlenecks, or code paths, followed by a prioritised fix plan the team can take into delivery.

  2. Recovery Sprint

    A short, concentrated engagement for a defined technical SEO, performance, CMS, Vercel, migration, or production issue where the business needs the cause isolated and the first fixes moved quickly.

Talk to me about your CMS problem

A short description of the CMS problem and where preview, publishing, or releases are losing trust is enough. I'll read it and suggest the next step.

Related Case Studies and Project Work

  1. Screenshot of the Nando’s website; part of John Kavanagh's selected project work.

    A Complete Migration and Replatform for Nando’s

    On Nando’s, headless content, Next.js rendering, Vercel deployment behaviour, and searchcritical local pages had to work as one system.

    View case study