Runtime logs now show cache reasons
Runtime logs now display detailed cache reasons explaining why requests weren't fresh cache hits, such as time-based or tag-based revalidations. This helps developers debug cache misses and improve cache hit rates across ISR, Partial Prerendering, and functions.
Runtime logs now show a Cache Reason explaining why a request wasn't a fresh cache hit, for example a time-based or tag-based revalidation. Use cache reasons to debug misses and improve your hit rate.
Cache reasons appear for any response the CDN can cache, including ISR, Partial Prerendering, and functions that set a header with directives like . Responses rendered dynamically on every request don't have a cache reason.Cache-Controlstale-while-revalidate
Open the Logs tab and select a request to see the reason alongside its cache status. Each status and reason links to its entry in the reference.Cache Status and Reasons
Cache reason is available in , , and Vercel plugin's :vercel logsvercel metricscdn-caching skill
Learn more about .cache statuses and reasons
Cache status | Possible reasons |
MISS | Cold, Request collapsed, Error |
BYPASS | Draft Mode, Prerender Bypass, Crawler |
STALE | Time-based revalidation, Tag-based invalidation, Revalidation error |
REVALIDATED | Tag-based deletion |
From the CLI
Source: original entry ↗
More from Vercel
Follow Vercel to get its new changes in your feed and email digest.
OpenAI Decisions API now available on AI Gateway
OpenAI's Decisions API is now accessible through Vercel's AI Gateway with an OpenAI-compatible endpoint, enabling decision models to answer typed questions and return probabilities, choices, and scores for routing, triage, and guardrails use cases. Support is available across the OpenAI SDK, AI SDK, HTTP API, and CLI with the latest versions.
Timestamp attributes now supported in Vercel Flags
Vercel Flags now supports timestamp attributes for entities, allowing you to create time-based targeting rules. Use this feature to run limited-time campaigns, show content between specific dates, or target users based on registration date.
Glyph Cluster now available in stealth on AI Gateway
Glyph Cluster, a reasoning model for coding and long-context analysis, is now available as a stealth model on Vercel's AI Gateway for Pro and Enterprise plan teams with purchased AI Gateway credits at no cost during the stealth period. The model supports function calling, streams responses, and can be accessed via AI SDK, OpenAI-compatible APIs, and coding agents.