---
title: >-
  Metafield translations now available via GraphQL Admin API - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/metafield-translations-now-available-via-graphql-admin-api
  md: >-
    https://shopify.dev/changelog/metafield-translations-now-available-via-graphql-admin-api.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-03-04T10:25:17-05:00'
  postedAt: '2026-04-01T12:00:00-04:00'
  updatedAt: '2026-03-17T10:20:34-04:00'
  effectiveAt: '2026-03-04T12:00:00-05:00'
---

April 1, 2026

Tags:

* Admin GraphQL API
* 2026-04

# Metafield translations now available via GraphQL Admin API

The `Metafield` type now includes a `translations` field, enabling you to query localized metafield values directly via the GraphQL Admin API. This enhancement allows you to access translations for metafields associated with any resource, including products, collections, customers, orders, locations, and more.

## Querying translations

To query translations for a resource's metafields, including their localized values, see the [Get translations for a product metafield](https://shopify.dev/docs/api/admin-graphql/2026-04/queries/product?example=get-translations-for-a-product-metafield) example.

## Registering a translation

To register a translation, use the `translationsRegister` mutation with the metafield's resource ID and a content digest. The `compareDigest` ensures that translations remain synchronized with the original value. You can obtain this digest when creating or querying a metafield.

See the [Register a French translation for a metafield value](https://shopify.dev/docs/api/admin-graphql/2026-04/mutations/translationsRegister?example=register-a-french-translation-for-a-metafield-value) example for the full workflow.

Translation is supported for text-based metafield types, including `single_line_text_field`, `multi_line_text_field`, `rich_text_field`, and `html`. Ensure that the target locale is [enabled and published](https://shopify.dev/docs/api/admin-graphql/latest/mutations/shopLocaleEnable) on your store.

For further information, refer to the [Metafield](https://shopify.dev/docs/api/admin-graphql/latest/objects/metafield) and [translationsRegister](https://shopify.dev/docs/api/admin-graphql/latest/mutations/translationsRegister) documentation.