I've been wanting this from Cloudflare <i>for years</i>.<p>The classic problem here is if you do that thing where user agents that send "accept: text/html" get HTML, while user agents that don't get JSON or some other format.<p>This used to be impossible to deploy behind Cloudflare caching, because they ignored the Vary header on anything other than images - so you risked caching the JSON version and then serving it up to someone who was expecting HTML.<p>(Independent of the Cloudflare feature I ended up deciding never to use that pattern, because I prefer having URL that predictably returns HTML or JSON - I add a .json suffix to my apps to serve JSON instead.)
Frankly, the supposed variability of the Accept header never really sat all that well with me; in practice I much prefer working with explicitly versioned endpoints — one of the most infuriating things is having to hardcode "Accept: text/x-myorgname-custom-json-blob-v4" because omitting it would produce "406 Not Acceptable". Bonus points if that's the <i>only</i> Accept header the service would ever accept in all of three years of it working before being decommissioned. Double bonus points if v5 would be introduced behind a separate URI anyway (and it, too, would require precisely "Accept: text/x-myorgname-custom-json-blob-v5" and nothing else).
I had not actually realized what a mess Vary is.<p>Wow, sometimes I think it's amazing the web works at all!
It pains me to think about the important ones like varying on session cookie and authorization headers, and how badly some middleware can confuse things.<p>We generate custom content for a given authentication context. We definitely want caching at the user agent, but we want the cache keyed by the authenticated identity. Otherwise something like logging out and logging in as a different identity can produce monstrously confused results when an SPA or similar mixes some cached and some fresh responses into one page.
Cache invalidation, one of the two hard problems in computer science.<p>I'm sure most people here already knows the joke, but for the lucky 10,000, here's the full joke:<p>There are only two hard problems in computer science. Naming things, cache invalidation, and off-by-one errors.
Imagine if we actually built a remote application delivery platform instead of cobbling one onto a glorified document reader
If this surprises you, remember that Cloudflare doesn't cache HTML by default.
"If the origin response does not include a Vary header, Cloudflare caches the response normally"[1]<p>"If one response omits it, Cloudflare could cache that response without the variance needed to keep it isolated."[2]<p>Will that non-Vary cache object front-run any Vary-segmented cache objects?<p>If so, probably worth adding a snippet rule to ensure every response has a Vary header?<p>1: <a href="https://developers.cloudflare.com/cache/concepts/vary/#how-vary-affects-cache-keys" rel="nofollow">https://developers.cloudflare.com/cache/concepts/vary/#how-v...</a><p>2: <a href="https://blog.cloudflare.com/vary-support/#how-a-response-moves-through-cache" rel="nofollow">https://blog.cloudflare.com/vary-support/#how-a-response-mov...</a>
Nice to see. I’ve used vary to quite a bit of success on CloudFront back in the day.<p>I actually assumed when I started using Cloudflare that it did have vary support and it led to a serious bug in my sass app at the time.
I honestly thought they would never ship this. Holy hell this has been a long time coming.<p>Actual real content negotiation in 2026. Never thought I'd live to see the day.
finally. now maybe they'll have time to implement a working unsubscribe on their marketing emails.