---
title: MetafieldReferenceConnection - Customer API
description: An auto-generated type for paginating through multiple MetafieldReferences.
api_version: 2026-01
api_name: customer
type: connection
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/customer/latest/connections/MetafieldReferenceConnection
  md: >-
    https://shopify.dev/docs/api/customer/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/customer/latest/objects/Metafield#field-Metafield.fields.references)

  OBJECT

  The custom metadata attached to a resource. Metafields can be sorted into namespaces and are comprised of keys, values, and value types.

***

## Possible returns

* edges

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The connection between the node and its parent. Each edge contains a minimum of the edge's cursor and the node.

* nodes

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A list of nodes that are contained in MetafieldReferenceEdge. You can fetch data about an individual node, or you can follow the edges to fetch data about a collection of related nodes. At each node, you specify the fields that you want to retrieve.

* page​Info

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  An object that’s used to retrieve [cursor information](https://shopify.dev/api/usage/pagination-graphql) about the current page.

***

## Map

### Fields with this connection

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

### Possible returns

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