---
title: MetafieldReferenceConnection - Storefront API
description: |
  An auto-generated type for paginating through multiple MetafieldReferences.
api_version: 2026-01
api_name: storefront
type: connection
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/connections/MetafieldReferenceConnection
  md: >-
    https://shopify.dev/docs/api/storefront/latest/connections/MetafieldReferenceConnection.md
---

# Metafield​Reference​Connection

connection

An auto-generated type for paginating through multiple MetafieldReferences.

## Fields with this connection

* [Metafield.references](https://shopify.dev/docs/api/storefront/latest/objects/Metafield#field-Metafield.fields.references)

  OBJECT

  [Custom metadata](https://shopify.dev/docs/apps/build/metafields) attached to a Shopify resource such as a [`Product`](https://shopify.dev/docs/api/storefront/current/objects/Product), [`Collection`](https://shopify.dev/docs/api/storefront/current/objects/Collection), or [`Customer`](https://shopify.dev/docs/api/storefront/current/objects/Customer). Each metafield is identified by a namespace and key, and stores a value with an associated type.

  Values are always stored as strings, but the [`type`](https://shopify.dev/docs/api/storefront/current/objects/Metafield#field-Metafield.fields.type) field indicates how to interpret the data. When a metafield's type is a resource reference, use the [`reference`](https://shopify.dev/docs/api/storefront/current/objects/Metafield#field-Metafield.fields.reference) or [`references`](https://shopify.dev/docs/api/storefront/current/objects/Metafield#field-Metafield.fields.references) fields to retrieve the linked objects. Access metafields on any resource that implements the [`HasMetafields`](https://shopify.dev/docs/api/storefront/current/interfaces/HasMetafields) interface.

* [Metaobject​Field.references](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectField#field-MetaobjectField.fields.references)

  OBJECT

  The value of a field within a [`Metaobject`](https://shopify.dev/docs/api/storefront/current/objects/Metaobject). For fields that reference other resources, use the [`reference`](https://shopify.dev/docs/api/storefront/current/objects/MetaobjectField#field-MetaobjectField.fields.reference) field for single references or [`references`](https://shopify.dev/docs/api/storefront/current/objects/MetaobjectField#field-MetaobjectField.fields.references) for lists.

***

## Possible returns

* edges

  [\[Metafield​Reference​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MetafieldReferenceEdge)

  non-null

  A list of edges.

* nodes

  [\[Metafield​Reference!\]!](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldReference)

  non-null

  A list of the nodes contained in MetafieldReferenceEdge.

* page​Info

  [Page​Info!](https://shopify.dev/docs/api/storefront/latest/objects/PageInfo)

  non-null

  Information to aid in pagination.

***

## Map

### Fields with this connection

* [Metafield.references](https://shopify.dev/docs/api/storefront/latest/objects/Metafield#field-Metafield.fields.references)
* [Metaobject​Field.references](https://shopify.dev/docs/api/storefront/latest/objects/MetaobjectField#field-MetaobjectField.fields.references)

### Possible returns

* [Metafield​Reference​Connection.edges](https://shopify.dev/docs/api/storefront/latest/connections/MetafieldReferenceConnection#returns-edges)
* [Metafield​Reference​Connection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/MetafieldReferenceConnection#returns-nodes)
* [Metafield​Reference​Connection.pageInfo](https://shopify.dev/docs/api/storefront/latest/connections/MetafieldReferenceConnection#returns-pageInfo)