API change record
Shopify 2026-10 invalid metafield filters return errors
Current decisionBefore upgrading affected GraphQL Admin API queries to 2026-10, audit every metafield filter. Confirm the metafield has a definition, filtering is enabled, and the comparison you use is supported.
What changed?
Starting in Shopify API version 2026-10, GraphQL Admin API queries that filter by a metafield that is not set up for filtering return an error instead of silently ignoring the invalid predicate and returning misleading results.
Who is affected?
Apps and integrations are affected when they filter resources such as products, orders, or customers by metafields on GraphQL Admin API version 2026-10 or later. Queries on 2026-07 and earlier keep the previous behavior until they are upgraded.
What can break?
- A query that previously returned an empty or misleading result can start returning an explicit error.
- Filters can fail when the metafield has no definition, filtering is not enabled, or the metafield type does not support the comparison.
- Search, segmentation, sync, and automation flows depending on metafield filters may need code or schema changes.
Smallest safe migration
- List all GraphQL Admin API queries that filter by metafields.
- For each filter, confirm a metafield definition exists.
- Confirm the definition allows filtering and the comparison is supported.
- Test the queries against 2026-10 and keep unready queries on 2026-07 or earlier until fixed.
Official sources
Independent research, not official Shopify support. Test your app before changing production API versions.