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

# Cart​Address

union

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

## Possible types

* [Cart​Delivery​Address](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryAddress)

  OBJECT

  Represents a mailing address for customers and shipping.

  * 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​Code

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

    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.

  * 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​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.

***

## Fields with this union

* [Cart​Selectable​Address.address](https://shopify.dev/docs/api/storefront/latest/objects/CartSelectableAddress#field-CartSelectableAddress.fields.address)

  OBJECT

  A selectable delivery address for a cart.

***

```graphql
union CartAddress = CartDeliveryAddress
```