---
title: MailingAddress - GraphQL Admin
description: |-
  Represents a customer mailing address.

  For example, a customer's default address and an order's billing address are both mailling addresses.
api_version: 2025-10
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

Represents a customer mailing address.

For example, a customer's default address and an order's billing address are both mailling addresses.

## Fields

* address1

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The first line of the address. Typically the street address or PO Box number.

* address2

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The second line of the address. Typically the number of the apartment, suite, or unit.

* city

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the city, district, village, or town.

* company

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the customer's company or organization.

* coordinates​Validated

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the address corresponds to recognized latitude and longitude values.

* country

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the country.

* country​Code​V2

  [Country​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/CountryCode)

  The two-letter code for the country of the address.

  For example, US.

* first​Name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The first name of the customer.

* formatted

  [\[String!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  A formatted version of the address, customized by the provided arguments.

  * with​Name

    [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    Default:false

    ### Arguments

    Whether to include the customer's name in the formatted address.

  * with​Company

    [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    Default:true

    Whether to include the customer's company in the formatted address.

  ***

* formatted​Area

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A comma-separated list of the values for city, province, and country.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* last​Name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The last name of the customer.

* latitude

  [Float](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Float)

  The latitude coordinate of the customer address.

* longitude

  [Float](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Float)

  The longitude coordinate of the customer address.

* name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The full name of the customer, based on firstName and lastName.

* phone

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A unique phone number for the customer.

* province

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The region of the address, such as the province, state, or district.

* province​Code

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The alphanumeric code for the region.

  For example, ON.

* time​Zone

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The time zone of the address.

* validation​Result​Summary

  [Mailing​Address​Validation​Result](https://shopify.dev/docs/api/admin-graphql/latest/enums/MailingAddressValidationResult)

  The validation status that is leveraged by the address validation feature in the Shopify Admin. See ["Validating addresses in your Shopify admin"](https://help.shopify.com/manual/fulfillment/managing-orders/validating-order-address) for more details.

* zip

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The zip or postal code of the address.

* country​Code

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  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.addresses](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer#field-Customer.fields.addresses)
* {}[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

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

  mutation

  Create a new customer address.

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

  mutation

  Update a customer's address information.

***

## <\~> 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](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-MailingAddress Implements

### Implements

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