Shopify-Complexity-Score
The HTTP Shopify-Complexity-Score response header is an unofficial, Shopify-specific header reporting an internal cost score computed for the response.
Usage
Shopify measures the computational cost of serving a
request with an internal scoring system and exposes
the score in the Shopify-Complexity-Score header.
Live responses pair the header with a
Shopify-Complexity-Score-V2 companion, and current
storefronts mostly report 0 in the original header
while the V2 companion carries the active score. In
crawl data the header appears on public storefront
responses, product and collection pages and even
robots.txt, so the score describes storefront
rendering cost rather than authenticated API usage.
A simple page produces a low score, and a page
assembling many products, variants, and media
produces a high score.
Shopify enforces complexity limits internally to keep any single request from consuming excessive infrastructure capacity. Reading the header across a storefront highlights the heaviest pages, the ones closest to whatever ceiling Shopify applies.
Values
Integer score
The value is a positive integer. The 2026 crawl
recorded multiples of 10 running from 0 on trivial
responses, through a floor of 180 for ordinary
pages, to 25540 on the heaviest observed response,
a hosted PDF asset, with most pages scoring in the
hundreds. Current live values in the V2 companion
follow no multiple-of-10 pattern and dip well below
the old floor, with scores like 52, 105, and
756 observed on production storefronts, so the
scoring scale itself has shifted between versions.
Example
An ordinary storefront page produces a score in the low hundreds, the most common range in crawl data.
Shopify-Complexity-Score: 340
A heavy collection page assembling many nested
products and media scores an order of magnitude
higher, with the heaviest observed collection page
reaching 22040.
Shopify-Complexity-Score: 4820