---
title: MailingAddress - GraphQL Admin
description: >-
  A physical mailing address. For example, a
  [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)'s
  default address and an
  [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)'s
  billing address are both mailing addresses. Stores standard address
  components, customer name information, and company details.


  The address includes geographic coordinates
  ([`latitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.latitude)
  and
  [`longitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.longitude)).
  You can format addresses for display using the
  [`formatted`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.formatted)
  field with options to include or exclude name and company information.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress.md'
---

# Mailing​Address

object

A physical mailing address. For example, a [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer)'s default address and an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order)'s billing address are both mailing addresses. Stores standard address components, customer name information, and company details.

The address includes geographic coordinates ([`latitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.latitude) and [`longitude`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.longitude)). You can format addresses for display using the [`formatted`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddress#field-MailingAddress.fields.formatted) field with options to include or exclude name and company information.

## Fields

* address1
* address2
* city
* company
* coordinatesValidated
* country
* countryCodeV2
* firstName
* formatted
* formattedArea
* id
* lastName
* latitude
* longitude
* name
* phone
* province
* provinceCode
* timeZone
* validationResultSummary
* zip
* countryCode: deprecated

***

## Map

### Fields and connections with this object

* [AbandonedCheckout.billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckout#field-AbandonedCheckout.fields.billingAddress)
* [AbandonedCheckout.shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/AbandonedCheckout#field-AbandonedCheckout.fields.shippingAddress)
* [Customer.addressesV2](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.addressesV2)
* [Customer.defaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.defaultAddress)
* [CustomerMergePreviewAlternateFields.defaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewAlternateFields#field-CustomerMergePreviewAlternateFields.fields.defaultAddress)
* [CustomerMergePreviewDefaultFields.addresses](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.addresses)
* [CustomerMergePreviewDefaultFields.defaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.defaultAddress)
* [CustomerSegmentMember.defaultAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerSegmentMember#field-CustomerSegmentMember.fields.defaultAddress)
* [DraftOrder.billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.billingAddress)
* [DraftOrder.shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.shippingAddress)
* [MailingAddressConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/MailingAddressConnection#returns-nodes)
* [MailingAddressEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/MailingAddressEdge#field-MailingAddressEdge.fields.node)
* [Order.billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.billingAddress)
* [Order.displayAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.displayAddress)
* [Order.shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.shippingAddress)
* [ShopifyPaymentsDisputeEvidence.billingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.billingAddress)
* [ShopifyPaymentsDisputeEvidence.shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.shippingAddress)
* [SubscriptionDeliveryMethodLocalDelivery.address](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDeliveryMethodLocalDelivery#field-SubscriptionDeliveryMethodLocalDelivery.fields.address)
* [SubscriptionDeliveryMethodShipping.address](https://shopify.dev/docs/api/admin-graphql/latest/objects/SubscriptionDeliveryMethodShipping#field-SubscriptionDeliveryMethodShipping.fields.address)

***

## Mutations

* customerAddressCreate
* customerAddressUpdate

***

## MailingAddress Mutations

### Mutated by

* [customer​Address​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddressCreate)
* [customer​Address​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddressUpdate)

***

## Interfaces

* Node

***

## MailingAddress Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)