Invalid metafield queries now return errors in the GraphQL Admin API

Breaking / action requiredEffective 2026-10-01

Starting in API version 2026-10, the GraphQL Admin API returns an error when a query filters by a metafield that isn't set up for filtering, instead of silently returning incorrect results. This is a breaking change.

Summary extracted from the official source text. Verify details on the source page.

PlatformShopify
Effective date2026-10-01 (passed)
Precisionday
Published2026-07-24
CategoriesBreaking / action required
Tags2026-10, API, Action Required, Admin GraphQL API, Breaking API Change, Metafields and metaobjects
Official sourceShopify developer changelog ↗
Fetched2026-10-17T03:44:00+00:00
First seen2026-10-17T01:05:46+00:00
StatusListed by the source
Stable IDshopify-6c2d61e03b · JSON