X-Storefront-Renderer-Rendered

The HTTP X-Storefront-Renderer-Rendered response header is an unofficial Shopify-specific header indicating the page was rendered by Shopify's storefront rendering pipeline rather than served from cache or an alternative backend.

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

Takeaway

The X-Storefront-Renderer-Rendered header is a boolean flag Shopify uses to indicate active rendering pipeline involvement. A value of 1 confirms the response was generated at request time rather than retrieved from a cache layer.

See also

Last updated: March 11, 2026