X-Storefront-Renderer-Rendered

When Shopify serves a page through active Liquid template rendering instead of a cached copy, the X-Storefront-Renderer-Rendered unofficial response header confirms the rendering pipeline processed the request.

Note

The "X-" naming convention for HTTP headers, "X" referring to "experimental", has been deprecated and needs to be transitioned to the formal naming convention for HTTP headers.

Usage

Shopify's storefront infrastructure routes requests through multiple layers: Caching systems, edge nodes, and the core rendering pipeline processing Liquid templates and Hydrogen components. The X-Storefront-Renderer-Rendered header signals the response passed through the rendering pipeline directly, rather than being served from a cached copy.

The header appears in responses from Shopify storefronts and serves as an internal routing signal. Developers and platform engineers use the header to confirm a given response originated from active rendering rather than a cache hit. This distinction matters when debugging personalization, A/B tests, or dynamic content depending on rendering state.

Values

`1`

The value 1 is a boolean flag indicating the storefront renderer processed the request. The header is absent or carries a different value when the response came from cache or bypassed the rendering pipeline.

Example

A response from a Shopify storefront where Liquid template rendering occurred at request time carries the header with a value of 1.

X-Storefront-Renderer-Rendered: 1

This value often appears alongside other Shopify diagnostic HTTP headers describing routing and shop identity.

X-ShopId: 55083958454
X-Storefront-Renderer-Rendered: 1

See also

Last updated: April 4, 2026