# Runtime logs now show cache reasons

By Steven Van · 2026-07-17

Vercel's runtime logs now explain why a request missed the cache, viewable per request or via the CLI and metrics API.

[Vercel](<https://creatorstoolbox.com/tools/vercel>)'s runtime logs now include a Cache Reason alongside each request's cache status, explaining why a response wasn't a fresh hit, for example a time-based or tag-based revalidation. Reasons appear for any response the CDN can cache, including ISR, Partial Prerendering, and functions that set a Cache-Control header with directives like stale-while-revalidate. Responses that render dynamically on every request don't get a reason.

Possible reasons are grouped by status: **MISS** can be Cold, Request collapsed, or Error; **BYPASS** can be Draft Mode, Prerender Bypass, or Crawler; **STALE** can be Time-based revalidation, Tag-based invalidation, or Revalidation error; and **REVALIDATED** shows Tag-based deletion. Reasons are visible in the Logs tab by selecting a request, and each links to its entry in the [Cache Status and Reasons](<https://vercel.com/changelog/runtime-logs-now-show-cache-reasons>) reference. They're also available from the CLI through vercel logs, vercel metrics (grouped by cache\_reason), and the Vercel plugin's cdn-caching skill.

[![](<https://vercel.com/api/docs-og?title=Cache%20Status%20and%20Reasons&format=docs&sig=9ec723bdaa8d9ad50f7bb2dfec49389cc60ae61847eec39d6af8b5a389d2ff29&category=Ship%20and%20scale&subcategory=CDN&subcategory2=Caching>)](<https://vercel.com/docs/caching/cache-status>)

![Vercel](<https://www.google.com/s2/favicons?domain=vercel.com&sz=128>)

Vercel

The platform for frontend developers — deploy, preview, and scale web apps and AI agents with zero config.

[View Vercel →](<https://creatorstoolbox.com/tools/vercel>)

Sources

[Original source](<https://vercel.com/docs/caching/cache-status>)

[Read Runtime logs now show cache reasons on Creators Toolbox](<https://creatorstoolbox.com/blog/vercel-runtime-logs-now-show-cache-reasons>)

---
Canonical source: https://creatorstoolbox.com/blog/vercel-runtime-logs-now-show-cache-reasons
