---
title: New metafield definition types in GraphQL - article_reference / list.article_reference - 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/new-metafield-definition-types-in-graphql-articlereference-listarticlereference
  md: https://shopify.dev/changelog/new-metafield-definition-types-in-graphql-articlereference-listarticlereference.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

September 23, 2025

Tags:

* Admin GraphQL API
* Liquid
* Storefront GraphQL API
* 2025-10

# New metafield definition types in GraphQL - article\_reference / list.article\_reference

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.

The new metafield definition types are:

* `article_reference`: This type allows you to reference a specific article on your online store, making it easier to link content dynamically.
* `list.article_reference`: This type enables you to create a list of article references, providing a streamlined way to manage multiple content links.

To explore these new reference types further, visit the [Shopify.dev documentation](https://shopify.dev/api/admin-graphql/2025-10/unions/MetafieldReference). For practical implementation, check out the [examples provided](https://shopify.dev/apps/metafields/types).

These updates offer enhanced capabilities for managing content on your Shopify store, allowing for more dynamic and customized user experiences.