Cloudflare Docs
Cache
Edit this page
Report an issue with this page
Log into the Cloudflare dashboard
Set theme to dark (⇧+D)

Tiered Cache

Tiered Cache uses the size of Cloudflare’s network to reduce requests to customer origins by dramatically increasing cache hit ratios. With data centers around the world, Cloudflare caches content very close to end users. However, if a piece of content is not in cache, the Cloudflare edge data centers must contact the origin server to receive the cacheable content.

Tiered Cache works by dividing Cloudflare’s data centers into a hierarchy of lower-tiers and upper-tiers. If content is not cached in lower-tier data centers (generally the ones closest to a visitor), the lower-tier must ask an upper-tier to see if it has the content. If the upper-tier does not have the content, only the upper-tier can ask the origin for content. This practice improves bandwidth efficiency by limiting the number of data centers that can ask the origin for content, which reduces origin load and makes websites more cost-effective to operate.

Additionally, Tiered Cache concentrates connections to origin servers so they come from a small number of data centers rather than the full set of network locations. This results in fewer open connections using server resources.

To enable Tiered Cache, refer to Enable Tiered Cache.

​​ Tiered Cache Topology

Cloudflare allows you to select your cache topology so that you have control over how your origin connects to Cloudflare’s data centers. This will help ensure higher cache hit ratios, fewer origin connections, and a reduction of Internet latency. Below you can find details about the options we have available.

​​ Smart Tiered Cache

Smart Tiered Cache dynamically selects the single closest upper tier for each of your website’s origins with no configuration required, using our in-house performance and routing data. Cloudflare collects latency data for each request to an origin, and uses the latency data to determine how well any upper-tier data center is connected with an origin. As a result, Cloudflare can select the data center with the lowest latency to be the upper-tier for an origin.

​​ Smart Tiered Cache and Anycast network

Smart Tiered Cache does not work when an origin is behind an Anycast network because that will prevent us from knowing where the origin is located. As a result, we are unable to select the optimal upper tier and latency may be negatively impacted.

You need to be careful when updating your origin IPs/DNS records while Smart Tiered Cache is enabled. Depending on the changes made, it may cause the existing assigned upper tiers to change, resulting in an increased MISS rate as cache is refilled in the new upper tiers. If the origin is switched to a network behind Anycast, it will significantly reduce the effectiveness of Smart Tiered Cache.

If you need to use Anycast and want to use Smart Tiered cache, contact your account team.

​​ Generic Global Tiered Cache

Generic Global topology allows for all of Cloudflare’s global data centers to serve as a network of upper-tiers. This topology may help reduce the long tail latencies for far-away visitors.

​​ Regional Tiered Cache

Regional Tiered Cache provides an additional layer of caching for Enterprise customers who have a global traffic footprint and want to serve content faster by avoiding network latency when there is a cache MISS in a lower-tier, resulting in an upper-tier fetch in a data center located far away.

Regional Cache instructs Cloudflare to check a regional hub data center near the lower tier before going to the upper tier that may be outside of the region. This can help improve performance for Smart and Custom Tiered Cache topologies with upper-tiers in one or two regions. Regional Tiered Cache is not beneficial for customers with many upper tiers in many regions like Generic Global Tiered Cache.

​​ Custom Tiered Cache

Custom Tiered cache allows you to work with Cloudflare’s support team to set a custom topology that fits your specific needs, for instance you have close upper tiers or you have an unique traffic pattern. If you want a custom topology, please contact your CSM.

​​ Availability

FreeProBusinessEnterprise

Tiered Cache

YesYesYesYes

Smart Topology

YesYesYesYes

Generic Global Topology

NoNoNoYes

Regional Tiered Cache

NoNoNoYes

Custom Topology

NoNoNoYes

​​ Bandwidth Alliance

Enterprise customers can override Bandwidth Alliance configuration with Tiered Cache. For all other users, the Bandwidth Alliance takes precedence. Tiered Cache is still a valuable option to enable because the Bandwidth Alliance may not always be an available option, and in those instances, the Tiered Cache configuration will be used.

​​ Enable Tiered Cache

You can enable Tiered Cache in the dashboard or via API.

​​ Enable Tiered Cache in the dashboard

  1. Log in to your Cloudflare dashboard and select your domain.
  2. Select Caching > Tiered Cache.
  3. From Tiered Cache, toggle the button to enabled.
  4. In Tiered Cache Topology, you can control how your origin connects to Cloudflare’s data centers. You can select:
    • Upper Tier Cache - You have the option to choose between Smart or Generic Global Tiered Cache Topology.
    • Middle Tier Cache - If you have selected Smart or Custom Tiered Cache Topology, you can now enable Regional Tiered Cache.
    • Custom Tiered Cache - Allows you to work with Cloudflare’s support team to set a custom topology that fits your specific needs.
    • Disable Tiered Cache.

Tiered Cache Topology dashboard

​​ Enable Tiered Cache via API

To enable Tiered Cache via API use the following cURL example:

curl --request GET \
--url https://api.cloudflare.com/client/v4/zones/zone_identifier/argo/tiered_caching \
--header 'Content-Type: application/json' \
--header 'X-Auth-Email: '

You can also configure Tiered Cache Topology via API, for instance:

Enable Smart Tiered Cache
curl --request GET \
--url https://api.cloudflare.com/client/v4/zones/zone_identifier/cache/tiered_cache_smart_topology_enable \
--header 'Content-Type: application/json' \
--header 'X-Auth-Email: '
Enable Regional Tiered Cache
curl --request GET \
--url https://api.cloudflare.com/client/v4/zones/zone_identifier/cache/regional_tiered_cache \
--header 'Content-Type: application/json' \
--header 'X-Auth-Email: '

For more API examples and configuration options for Tiered Cache, refer to the API documentation.