`metafieldInteger` collection condition removed in API version 2027-01
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on October 01, 2026.
This Shopify update is categorized as Action Required, API, Breaking API Change, GraphQL Admin API, 2027-01.
What changed
With metafieldInt, the value field on integer metafield conditions changes type from Int to String, to align with the metafield value field on the Storefront API. For details, see the Storefront Metafield.value field reference. The following types and fields are replaced: CollectionSourceInclusionConditionMetafieldInteger is replaced by CollectionSourceInclusionConditionMetafieldInt CollectionSourceInclusionConditionMetafieldIntegerRelation is replaced by CollectionSourceInclusionConditionMetafieldIntRelation CollectionSourceInclusionConditionInput.metafieldInteger is replaced by CollectionSourceInclusionConditionInput.metafieldInt CollectionSourceInclusionConditionUpdateInput.metafieldInteger is replaced by CollectionSourceInclusionConditionUpdateInput.metafieldInt The relation enum members are unchanged (EQUALS, GREATER_THAN, LESS_THAN).
Who is affected
Apps that read, write, translate, or depend on Shopify metafields should review this change.
What action may be needed
Before you move to API version 2027-01, you need to: Update all Admin GraphQL queries and mutations that reference metafieldInteger to use metafieldInt. Ensure all integer metafield condition value fields are strings. If you don’t update your app before you use API version 2027-01, mutations that send metafieldInteger fail validation, and queries that select CollectionSourceInclusionConditionMetafieldInteger return errors. You can test metafieldInt behavior on 2026-10 before you upgrade to 2027-01.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →