---
title: New references connection on metafields - 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-references-connection-on-metafields'
  md: 'https://shopify.dev/changelog/new-references-connection-on-metafields.md'
metadata:
  effectiveApiVersion: 2022-10
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2022-07-22T15:13:59-04:00'
  postedAt: '2022-10-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:34-05:00'
  effectiveAt: '2022-10-01T00:00:00-04:00'
---

October 1, 2022

Tags:

* API
* 2022-10

# New references connection on metafields

You can now access a `references` connection on a `metafield` in the GraphQL Admin and Storefront APIs.

Use the `references` connection to resolve metafield values of a list reference type to their underlying resource. This new connection is paginated and works similarly to the existing `reference` field, which is used for single references.

This new endpoint is available in unstable, and will be part of the 2022-10 release.

For more information, refer to the [Admin API](https://shopify.dev/api/admin-graphql/unstable/objects/Metafield#connection-metafield-references) and [Storefront API](https://shopify.dev/api/storefront/unstable/objects/Metafield#connection-metafield-references) documentation.