Edge caching is configured for HTML pages
Why it matters
Marketing page HTML served without edge caching forces every visit — including from users in the same CDN region as a previous visitor — to hit the origin server and wait for a full server-rendered response. With ISR or s-maxage cache headers, the CDN serves the pre-generated HTML directly from an edge node, making repeat visits within the cache window as fast as static file serving (TTFB under 50ms). ISO-25010 time-behaviour quality for HTML responses is identical to static assets when edge caching is configured. Marketing pages have no per-user dynamic content, making them ideal candidates for edge caching — yet Cache-Control: no-store or force-dynamic rendering defeats this capability entirely.
Severity rationale
Info because edge caching for HTML is an enhancement over ISR that further reduces origin load and TTFB variance, but its absence is less severe than the underlying TTFB and CDN checks it depends on.
Remediation
Add export const revalidate to marketing page route files to enable ISR — Vercel will cache the HTML at edge nodes and serve subsequent requests without hitting the origin.
// app/(marketing)/page.tsx
// Remove any: export const dynamic = 'force-dynamic'
// Cache for 1 hour; Vercel serves from edge on cache hit
export const revalidate = 3600
export default async function HomePage() {
const content = await getCMSContent() // fetched once per revalidate window
return <MarketingPage content={content} />
}
For custom hosting, set s-maxage to instruct CDN nodes to cache HTML:
export async function GET() {
return new Response(html, {
headers: {
'Cache-Control': 'public, s-maxage=3600, stale-while-revalidate=86400'
}
})
}
Verify caching is active by checking the x-vercel-cache or cf-cache-status response header — HIT confirms the CDN served from cache.
DetectionPro
The detection method for this pattern is part of AuditBuffet Pro.
The full method (what to look for, pass and fail conditions, and how results get reported) ships inside the Page Speed Audit. The pattern definition, severity rationale, and remediation remain openly licensed under CC-BY-4.0.
External references
- iso-25010:2011 · performance-efficiency.time-behaviour — Edge HTML caching — ISR/s-maxage eliminates origin round-trips
Taxons
History
- 2026-04-18·v1.0.0·Initial import from marketing-page-speed·automated