New translatable boolean field for Metafield GraphQL Object
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 21, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-10.
What changed
The Metafield object in the GraphQL Admin API exposes a new non-null field, translatable: Boolean!, in API version 2026-10: { product(id: "gid://shopify/Product/1") { metafield(namespace: "custom", key: "care_guide") { type # "single_line_text_field" translatable # true } } } translatable returns the result that the platform already enforces when it decides whether a metafield’s value can be translated. Before this change, apps had to use the deprecated TranslatableResourceType.METAFIELD enum on translatableResources to query for translatable metafields. On API version 2026-10 and later, you should read translatable on the Metafield object instead of querying metafields through translatableResources.
Who is affected
This applies to apps that: Call the GraphQL Admin API on version 2026-10 or later, and Fetch translatable metafields Apps on version 2026-07 and earlier are unaffected. translatable isn’t available on those versions, and TranslatableResourceType.METAFIELD continues to exist there as deprecated. Apps that read metafield values without regard to translatability are unaffected on every version.
What action may be needed
If your app doesn’t look up translatable metafields by shop, you don’t need to change anything when you migrate to 2026-10. If it does, then when you migrate to 2026-10: Check whether you call translatableResources with TranslatableResourceType.METAFIELD in the top-level resourceType argument. Update those queries to read the translatable field directly on Metafield objects instead of classifying metafields through translatableResources.
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 →