---
title: MailingAddress - Storefront API
description: Represents a mailing address for customers and shipping.
api_version: 2025-10
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

Represents a mailing address for customers and shipping.

## Fields

* address1

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

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

* address2

  [String](https://shopify.dev/docs/api/storefront/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/storefront/latest/scalars/String)

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

* company

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

  The name of the customer's company or organization.

* country

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

  The name of the country.

* country​Code​V2

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

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

  For example, US.

* first​Name

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

  The first name of the customer.

* formatted

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

  non-null

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

  * with​Name

    [Boolean](https://shopify.dev/docs/api/storefront/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/storefront/latest/scalars/Boolean)

    Default:true

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

  ***

* formatted​Area

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

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

* id

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

  non-null

  A globally-unique ID.

* last​Name

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

  The last name of the customer.

* latitude

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

  The latitude coordinate of the customer address.

* longitude

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

  The longitude coordinate of the customer address.

* name

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

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

* phone

  [String](https://shopify.dev/docs/api/storefront/latest/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/latest/scalars/String)

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

* province​Code

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

  The alphanumeric code for the region.

  For example, ON.

* zip

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

  The zip or postal code of the address.

* country​Code

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

  Deprecated

***

## Map

### Fields and connections with this object

* {}[CartDeliveryGroup.deliveryAddress](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryGroup#field-deliveryAddress)
* {}[Customer.addresses](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-addresses)
* {}[Customer.defaultAddress](https://shopify.dev/docs/api/storefront/latest/objects/Customer#field-defaultAddress)
* <->[MailingAddressConnection.nodes](https://shopify.dev/docs/api/storefront/latest/connections/MailingAddressConnection#field-nodes)
* {}[MailingAddressEdge.node](https://shopify.dev/docs/api/storefront/latest/objects/MailingAddressEdge#field-node)
* {}[Order.billingAddress](https://shopify.dev/docs/api/storefront/latest/objects/Order#field-billingAddress)
* {}[Order.shippingAddress](https://shopify.dev/docs/api/storefront/latest/objects/Order#field-shippingAddress)

### Possible type in

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

***

## Mutations

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

  mutation

  Creates a new address for a customer.

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

  mutation

  Updates the address of an existing customer.

***

## <\~> MailingAddress Mutations

### Mutated by

* <\~>[customer​Address​Create](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressCreate)
* <\~>[customer​Address​Update](https://shopify.dev/docs/api/storefront/latest/mutations/customerAddressUpdate)

***

## Interfaces

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

  interface

***

## ||-MailingAddress Implements

### Implements

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