Purge by single-file (by URL)
With purge by single-file, cached resources are immediately removed from the stored assets in your Content Delivery Network (CDN) across all data centers. New requests for the purged asset receive the latest version from your origin web server and add it back to your CDN cache within the specific Cloudflare data center that served the request.
The single-file purge rate limit for the Free subscription is 1,000 URLs/minute. The rate limit is subject to change. For Zones on Free/Pro/Business plan, you may purge up to 30 URLs in one API call. For Zones on Enterprise plan, you may purge up to 500 URLs in one API call.
A single-file purge performed through your Cloudflare dashboard does not clear objects that contain any of the following:
- Custom cache keys
- Origin header
- Any of these request headers:
X-Forwarded-HostX-HostX-Forwarded-SchemeX-Original-URLX-Rewrite-URLForwarded
You can purge objects with these characteristics using an API call to ( purge files by URL). In the data/header section of the API call, you must include all headers and cache keys contained in the cached resource, along with their matching values.
- Log in to your Cloudflare dashboard, and select your account and domain.
- Select Caching > Configuration.
- Under Purge Cache, select Custom Purge. The Custom Purge window appears.
- Under Purge by, select URL.
- Enter the appropriate value(s) in the text field using the format shown in the example. Be aware that the host part of the URL is not case-sensitive, meaning it will always be converted to lowercase according to RFC standards. However, the path portion is case-sensitive. For example,
https://EXAMPLE.com/helloHIwould be treated ashttps://example.com/helloHI. - Perform any additional instructions to complete the form.
- Review your entries.
- Select Purge.
Resulting cache status
Purging by single-file deletes the resource, resulting in the CF-Cache-Status header being set to MISS for subsequent requests.