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

# Mailing​Address​Connection

connection

An auto-generated type for paginating through multiple MailingAddresses.

## Fields with this connection

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

  OBJECT

  A customer account with the shop. Includes data such as contact information, [addresses](https://shopify.dev/docs/api/storefront/current/objects/MailingAddress) and marketing preferences for logged-in customers, so they don't have to provide these details at every checkout.

  Access the customer through the [`customer`](https://shopify.dev/docs/api/storefront/current/queries/customer) query using a customer access token obtained from the [`customerAccessTokenCreate`](https://shopify.dev/docs/api/storefront/current/mutations/customerAccessTokenCreate) mutation.

  The object implements the [`HasMetafields`](https://shopify.dev/docs/api/storefront/current/interfaces/HasMetafields) interface, enabling retrieval of [custom data](https://shopify.dev/docs/apps/build/custom-data) associated with the customer.

***

## Possible returns

* edges

  [\[Mailing​Address​Edge!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddressEdge)

  non-null

  A list of edges.

* nodes

  [\[Mailing​Address!\]!](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress)

  non-null

  A list of the nodes contained in MailingAddressEdge.

* 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

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

### Possible returns

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