What should Shopify teams do about it?

Update Shopify CLI to latest and bump api_version in any extension.toml files to regenerate schema.graphql • Review any scripts using --store flag to ensure they target active stores • If you copy-pasted ThirdPartyAnalyticsIntegration examples, add register to the useAnalytics destructure

CLI FIXES STALE SCHEMA TRAP, HYDROGEN SCRUBS LEGACY DOCS

By RepoJournal · Filed 06:03 UTC on May 15, 2026 · About Shopify

Shopify CLI shipped two critical fixes that prevent developers from accidentally working against outdated GraphQL schemas and resolving stores that no longer exist.

The CLI now automatically prepends the api_version to your schema.graphql when you bump versions in shopify.extension.toml, eliminating the silent data staleness that left developers chasing phantom schema fields [1]. That fix works in tandem with a second critical change: explicit store lookups via --store now filter to active stores only, closing a loophole where deleted or inactive stores could still resolve in flows like store execute [2]. This matters because the list path already guards against stale stores, but domain lookups didn't, creating an inconsistency that shipped broken commands into production. On the Hydrogen side, the docs team finished purging v1 platform artifacts, moving all content into shopify-dev as MDX files and removing the generated_doc_data.json system that was causing bloat [4]. They also fixed a runtime error in the ThirdPartyAnalyticsIntegration example where register wasn't being destructured from useAnalytics, which would have thrown ReferenceError for any developer copy-pasting the snippet [5]. The CLI also cleaned up its breaking-change approval workflow, removing unused jobs and scrubbing a private Slack channel link from the report [3]. Ship the CLI fixes immediately; they prevent silent failures.

FAQ

What changed in Shopify on May 15, 2026?: Shopify CLI shipped two critical fixes that prevent developers from accidentally working against outdated GraphQL schemas and resolving stores that no longer exist.
What should Shopify teams do about it?: Update Shopify CLI to latest and bump api_version in any extension.toml files to regenerate schema.graphql • Review any scripts using --store flag to ensure they target active stores • If you copy-pasted ThirdPartyAnalyticsIntegration examples, add register to the useAnalytics destructure
Which Shopify repositories shipped on May 15, 2026?: Shopify/cli, Shopify/hydrogen

CLI FIXES STALE SCHEMA TRAP, HYDROGEN SCRUBS LEGACY DOCS

The showcase is a teaser. Your wire is the product.

The showcase is a teaser.
Your wire is the product.