---
title: DeliveryAddress - Storefront API
description: A delivery address of the buyer that is interacting with the cart.
api_version: 2026-01
api_name: storefront
type: union
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/unions/DeliveryAddress'
  md: 'https://shopify.dev/docs/api/storefront/latest/unions/DeliveryAddress.md'
---

# Delivery​Address

union

A delivery address of the buyer that is interacting with the cart.

## Possible types

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

  OBJECT

  A physical mailing address associated with a [`Customer`](https://shopify.dev/docs/api/storefront/2026-01/objects/Customer) or [`Order`](https://shopify.dev/docs/api/storefront/2026-01/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/2026-01/objects/MailingAddress#field-MailingAddress.fields.formatted) field, which can optionally include or exclude name and company details.

  * 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

***

## Fields with this union

* [Cart​Buyer​Identity.deliveryAddressPreferences](https://shopify.dev/docs/api/storefront/latest/objects/CartBuyerIdentity#field-CartBuyerIdentity.fields.deliveryAddressPreferences)

  OBJECT

  Deprecated

***

```graphql
union DeliveryAddress = MailingAddress
```