> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

# Advanced caching

> Advanced caching allows the configuration of advanced cache serving behavior at the CDN level for Content Delivery API (CDA) and GraphQL Content API.

## Introduction

Advanced caching allows the configuration of advanced cache serving behavior at the CDN level for [Content Delivery API (CDA)](/references/content-delivery-api/overview) and [GraphQL Content API](/references/graphql/overview).

## Advanced caching options

With advanced caching you can enable one or both of the following options:

* **Stale-when-rate-limited**—When traffic is at a level where some requests get [rate-limited](/platform/technical-limits) (a rate-limit error HTTP status 429 is returned), stale data is sent instead of the 429 error response whenever possible (where stale content is available). Configuring this option is helpful when you publish frequently and have high traffic in general, while data freshness is not critical.
* **Stale-while-revalidate**—During the first minute after a publish event, the cache returns stale data (when available), and the data is refreshed in the background. The extra time needed to refresh the content does not appear in the response times. Configuring this option is helpful when you deal with many identical requests and low latency is more important than data freshness.

## How to activate Advanced caching

> **Info**
>
> Advanced caching is available only to Premium plan customers (and formerly Enterprise plans with Scale or High availability subscriptions).

Advanced caching is activated on a space level and configured individually per customer on the Contentful side. To activate advanced caching, file a ticket to [support](https://www.contentful.com/support/).

> Advanced caching allows the configuration of advanced cache serving behavior at the CDN level for Content Delivery API (CDA) and GraphQL Content API.