---
title: CartBuyerIdentityInput - Storefront API
description: >
  The input fields for identifying the buyer associated with a cart. Buyer
  identity determines [international
  pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing)
  and should match the customer's shipping address.


  Used by [`cartCreate`](/docs/api/storefront/unstable/mutations/cartCreate) and
  [`cartBuyerIdentityUpdate`](/docs/api/storefront/unstable/mutations/cartBuyerIdentityUpdate)
  to set contact information, location, and checkout preferences.


  > Note:

  > Preferences prefill fields at checkout but don't sync back to the cart if
  overwritten.
api_version: unstable
api_name: storefront
type: input-object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput
  md: >-
    https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput.md
---

# Cart​Buyer​Identity​Input

input\_object

The input fields for identifying the buyer associated with a cart. Buyer identity determines [international pricing](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/markets/international-pricing) and should match the customer's shipping address.

Used by [`cartCreate`](https://shopify.dev/docs/api/storefront/unstable/mutations/cartCreate) and [`cartBuyerIdentityUpdate`](https://shopify.dev/docs/api/storefront/unstable/mutations/cartBuyerIdentityUpdate) to set contact information, location, and checkout preferences.

***

**Note:** Preferences prefill fields at checkout but don\'t sync back to the cart if overwritten.

***

## Fields

* company​Location​Id

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

  The company location of the buyer that is interacting with the cart.

* country​Code

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

  The country where the buyer is located.

* customer​Access​Token

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

  The access token used to identify the customer associated with the cart.

* email

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

  The email address of the buyer that is interacting with the cart.

* phone

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

  The phone number of the buyer that is interacting with the cart.

* preferences

  [Cart​Preferences​Input](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartPreferencesInput)

  A set of preferences tied to the buyer interacting with the cart. Preferences are used to prefill fields in at checkout to streamline information collection. Preferences are not synced back to the cart if they are overwritten.

* delivery​Address​Preferences

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

  Deprecated

***

## Input objects using this input

* [Cart​Input.buyerIdentity](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartInput#fields-buyerIdentity)

  INPUT OBJECT

  The input fields to create a cart.

***

## Map

### Input objects using this input

* [Cart​Input.buyerIdentity](https://shopify.dev/docs/api/storefront/unstable/input-objects/CartInput#fields-buyerIdentity)