---
title: MailingAddress - Storefront API
description: >
  A physical mailing address associated with a
  [`Customer`](/docs/api/storefront/unstable/objects/Customer) or
  [`Order`](/docs/api/storefront/unstable/objects/Order). Stores standard
  address components including street address, city, province, country, and
  postal code, along with customer name and company information.


  The address includes geographic coordinates and provides pre-formatted output
  through the
  [`formatted`](/docs/api/storefront/unstable/objects/MailingAddress#field-MailingAddress.fields.formatted)
  field, which can optionally include or exclude name and company details.
api_version: unstable
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/MailingAddress.md'
---

# Mailing​Address

object

A physical mailing address associated with a [`Customer`](https://shopify.dev/docs/api/storefront/unstable/objects/Customer) or [`Order`](https://shopify.dev/docs/api/storefront/unstable/objects/Order). Stores standard address components including street address, city, province, country, and postal code, along with customer name and company information.

The address includes geographic coordinates and provides pre-formatted output through the [`formatted`](https://shopify.dev/docs/api/storefront/unstable/objects/MailingAddress#field-MailingAddress.fields.formatted) field, which can optionally include or exclude name and company details.

## Fields

* address1

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* address2

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* city

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* company

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The name of the customer's company or organization.

* country

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The name of the country.

* country​Code​V2

  [Country​Code](https://shopify.dev/docs/api/storefront/unstable/enums/CountryCode)

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

  For example, US.

* first​Name

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The first name of the customer.

* formatted

  [\[String!\]!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  non-null

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

  * with​Name

    [Boolean](https://shopify.dev/docs/api/storefront/unstable/scalars/Boolean)

    Default:false

    ### Arguments

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

  * with​Company

    [Boolean](https://shopify.dev/docs/api/storefront/unstable/scalars/Boolean)

    Default:true

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

  ***

* formatted​Area

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* id

  [ID!](https://shopify.dev/docs/api/storefront/unstable/scalars/ID)

  non-null

  A globally-unique ID.

* last​Name

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The last name of the customer.

* latitude

  [Float](https://shopify.dev/docs/api/storefront/unstable/scalars/Float)

  The latitude coordinate of the customer address.

* longitude

  [Float](https://shopify.dev/docs/api/storefront/unstable/scalars/Float)

  The longitude coordinate of the customer address.

* name

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* phone

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  A unique phone number for the customer.

  Formatted using E.164 standard. For example, *+16135551111*.

* province

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

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

* province​Code

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The alphanumeric code for the region.

  For example, ON.

* zip

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  The zip or postal code of the address.

* country​Code

  [String](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

  Deprecated

***

## Map

### Fields and connections with this object

* [CartDeliveryGroup.deliveryAddress](https://shopify.dev/docs/api/storefront/unstable/objects/CartDeliveryGroup#field-CartDeliveryGroup.fields.deliveryAddress)
* [Customer.addresses](https://shopify.dev/docs/api/storefront/unstable/objects/Customer#field-Customer.fields.addresses)
* [Customer.defaultAddress](https://shopify.dev/docs/api/storefront/unstable/objects/Customer#field-Customer.fields.defaultAddress)
* [MailingAddressConnection.nodes](https://shopify.dev/docs/api/storefront/unstable/connections/MailingAddressConnection#returns-nodes)
* [MailingAddressEdge.node](https://shopify.dev/docs/api/storefront/unstable/objects/MailingAddressEdge#field-MailingAddressEdge.fields.node)
* [Order.billingAddress](https://shopify.dev/docs/api/storefront/unstable/objects/Order#field-Order.fields.billingAddress)
* [Order.shippingAddress](https://shopify.dev/docs/api/storefront/unstable/objects/Order#field-Order.fields.shippingAddress)

### Possible type in

* [Delivery​Address](https://shopify.dev/docs/api/storefront/unstable/unions/DeliveryAddress)

***

## Mutations

* [customer​Address​Create](https://shopify.dev/docs/api/storefront/unstable/mutations/customerAddressCreate)

  mutation

  Creates a new address for a customer.

  * customer​Access​Token

    [String!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    required

    ### Arguments

    The access token used to identify the customer.

  * address

    [Mailing​Address​Input!](https://shopify.dev/docs/api/storefront/unstable/input-objects/MailingAddressInput)

    required

    The customer mailing address to create.

  ***

* [customer​Address​Update](https://shopify.dev/docs/api/storefront/unstable/mutations/customerAddressUpdate)

  mutation

  Updates the address of an existing customer.

  * customer​Access​Token

    [String!](https://shopify.dev/docs/api/storefront/unstable/scalars/String)

    required

    ### Arguments

    The access token used to identify the customer.

  * id

    [ID!](https://shopify.dev/docs/api/storefront/unstable/scalars/ID)

    required

    Specifies the customer address to update.

  * address

    [Mailing​Address​Input!](https://shopify.dev/docs/api/storefront/unstable/input-objects/MailingAddressInput)

    required

    The customer’s mailing address.

  ***

***

## MailingAddress Mutations

### Mutated by

* [customer​Address​Create](https://shopify.dev/docs/api/storefront/unstable/mutations/customerAddressCreate)
* [customer​Address​Update](https://shopify.dev/docs/api/storefront/unstable/mutations/customerAddressUpdate)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/storefront/unstable/interfaces/Node)

  interface

***

## MailingAddress Implements

### Implements

* [Node](https://shopify.dev/docs/api/storefront/unstable/interfaces/Node)