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 carrying the
same value. 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, always a multiple of
10 in observed data. Crawled values run 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.
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