Hydrogen & Shopify API Versioning

Reference for all versioning schemes in the Hydrogen ecosystem. For release process (how to actually ship a release), see hydrogen-release-process. For domain architecture context, see headless-storefronts-context.

Shopify GraphQL API Versioning

Shopify's GraphQL APIs (Storefront API, Customer Account API, Admin API) all use the same calendar versioning scheme.

Format: YYYY-MM

• Uses hyphens, not dots
• No trailing .0 — the version is just YYYY-MM
• Examples: 2025-01, 2025-04, 2025-07, 2025-10

Quarterly Release Schedule

Four versions are released per year, always on the 1st of the release month: