New metafield definition types in GraphQL - article_reference / list.article_reference

Changelog
1

As of October 2025, Shopify will introduce two new metafield definition types in the Admin GraphQL API, Storefront API, and Liquid. Metafields allow you to customize and store additional information about your Shopify resources, enhancing the flexibility of your online store.

This is a companion discussion topic for the original entry at https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference
1 Like
2

I think I’m encoutering a bug when updating an artilce_reference or list.article_reference metafield.

Here is what I get in the Shopify Admin:

Capture d’écran 2025-10-28 à 13.37.34
Capture d’écran 2025-10-28 à 13.37.341162×282 21.7 KB

As you can see, the article name is not displayed, only the Graphql Id. I can click directly on it and it works, but this looks odd. No problem when updating any other metafield type.

Here is my query (I’ve not included the fragments)

mutation UpdateCollection(
  $collectionInput: CollectionInput!
) {
  collectionUpdate(input: $collectionInput) {
    collection {
      ...CollectionFields
    }
    userErrors {
      field
      message
    }
  }
}

And the variables

{
  "collectionInput": {
    "id": "gid://shopify/Collection/661502198092",
    "metafields": [
      {
        "namespace": "custom",
        "key": "test_article_list",
        "type": "list.article_reference",
        "value": "[\"gid://shopify/Article/607900336460\",\"gid://shopify/Article/607870845260\"]"
      }
    ]
  }
}

Any idea ?