导航|地址|刷新
Caching levels

Skip to contentDocumentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/cache/llms.txt
Use this file to discover all available pages before exploring further.



DocsDirectoryAPISDKsChangelog

Search

Log in






Cache / CDN

/




Overview

Plans

Get started


Concepts


CDN-Cache-Control

Cloudflare cache responses

Customize cache

Default cache behavior

Head Requests and Set-Cookie Headers

Origin Cache Control

Retention vs Freshness (TTL)

Revalidation

Vary






Cache configuration



Purge cache


Overview

Purge by single-file

​Purge everything

Purge cache by cache-tags

​Purge cache by hostname

​Purge cache by prefix (URL)

Purge cache key resources

P​urge varied images

Purge zone versions via API






Cache Response Rules


Overview

Create a rule in the dashboard

Create a rule via API

Terraform example

Available settings






Cache Rules


Overview

Create a rule in the dashboard

Create a rule via API

Terraform example

Available settings

Order and priority


Examples


Overview

Browser Cache TTL

Bypass Cache on Cookie

Cache by Device Type

Cache Deception Armor

Cache everything for hostnames in a list

Cache Everything while ignoring query strings

Cache Level (Cache Everything)

Cache TTL by status code

Custom Cache Key

Edge Cache TTL

Origin Cache Control

Query String Sort

Respect Strong ETags





Migration from Page Rules






Edge and Browser Cache TTL


Overview

Set Browser Cache TTL





Always Online

Cache by status code

Cache keys

Caching levels

Tiered Cache






Advanced configuration


Serving tailored content

Cache Reserve

Crawler Hints

Early Hints

Query String Sort

Vary for images






Performance review


Cache Analytics

Cache performance






Cache security


Avoid web cache poisoning

Cache Deception Armor

Cross-Origin Resource Sharing (CORS)






Reference


CDN Reference Architecture ↗

CSAM Scanning Tool

Development Mode

Using ETag Headers with Cloudflare






Interaction with Cloudflare products


Customize cache behavior with Workers

How Workers interact with Cache Rules

Enable cache in an R2 bucket

Control cache access with WAF and Snippets






Troubleshooting


Dynamic content and login issues

Issues with MP4 videos on iOS and Safari

Bot Management cookie causes cache bypass in O2O setups

edgeResponseBytes and cacheResponseBytes discrepancy

Always Online





Changelog

Glossary


Agent resources


Agent setup ↗

Cloudflare Skills ↗

Code Mode MCP Server ↗

Domain-specific MCP Servers ↗MCP

Cache llms.txt ↗

Cache llms-full.txt ↗

Cloudflare Docs llms.txt ↗

Cloudflare Docs llms-full.txt ↗













Home

/Cache / CDN

/Cache configuration

/Caching levels



Caching levels


Last updated Apr 16, 2026|Copy as Markdown|View as Markdown|Agent setup

OverviewAPI Caching level values




Caching levels determine how much of your website’s static content Cloudflare should cache. Cloudflare’s CDN caches static content according to the levels below.

No Query String: Delivers resources from cache when there is no query string. Example URL: example.com/pic.jpg

Ignore Query String: Delivers the same resource to everyone independent of the query string. Example URL: example.com/pic.jpg?ignore=this-query-string

Standard (Default): Delivers a different resource each time the query string changes. Example URL: example.com/pic.jpg?with=query

You can adjust the caching level from the dashboard under Caching > Configuration > Caching level.


Note


Ignore Query String only disregards the query string for static file extensions. For example, Cloudflare serves the style.css resource to requests for either style.css?this or style.css?that.




API Caching level values


If you are using the API to change the cache level, the values will differ from those shown in the dashboard. Refer to the table below to see how the API values map to the values shown in the dashboard.

Dashboard	API
No Query String	Basic
Ignore Query String	Simplified
Standard (Default)	Aggressive

PreviousCache keysNextTiered Cache


Was this helpful?

YesNo

Edit pageReport issue




On this page

Overview

API Caching level values


Edit pageReport issue














Getting started
PlansContact salesPartnersFind a partnerStartupsUnder attack?Domain name search


Company
AboutCareersInvestorsPressPress kitGlobal network




Public interest
Project GalileoAthenian ProjectCloudflare for CampaignsProject FairshotImpact/ESG


Compliance
Compliance resourcesTrust HubData ProtectionResponsible AITransparency reportReport abuse




Resources
App innovation reportCloudflare RadarCase studiesStatusSupportEventsBlog


Developers
DocumentationLearning centerCommunity




Solutions
SSE and SASE platformCloudflare AI CloudAI SecurityFrontend Development PlatformMulti-Tenant Platform DevelopmentWeb Security Platform


Start BuildingLog In












© 2026 Cloudflare, Inc.

Privacy policy|Report security issues|Terms of use|Trademark
|
Your privacy choices








Docs




------
导航页 打开网址