---
title: CartBuyerIdentityInput - Storefront API
description: |
  Specifies the input fields to update the buyer information associated with a cart.
  Buyer identity is used to determine
  [international pricing](https://shopify.dev/custom-storefronts/internationalization/international-pricing)
  and should match the customer's shipping address.
api_version: unstable
api_name: storefront
source_url:
  html: https://shopify.dev/docs/api/storefront/unstable/input-objects/CartBuyerIdentityInput
  md: https://shopify.dev/docs/api/storefront/unstable/input-objects/CartBuyerIdentityInput.md
---

# Cart​Buyer​Identity​Input

input\_object

Specifies the input fields to update the buyer information associated with a cart. Buyer identity is used to determine [international pricing](https://shopify.dev/custom-storefronts/internationalization/international-pricing) and should match the customer's shipping address.

## 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

***

## Mutations using this input

* [cart​Buyer​Identity​Update.​buyer​Identity](https://shopify.dev/docs/api/storefront/unstable/mutations/cartBuyerIdentityUpdate#arguments-buyerIdentity)

  MUTATION

***

## Input objects using this input

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

  INPUT OBJECT

  The input fields to create a cart.

***

## Map

### Mutations using this input

* <\~>[cart​Buyer​Identity​Update.buyerIdentity](https://shopify.dev/docs/api/storefront/unstable/mutations/cartBuyerIdentityUpdate#arguments-buyerIdentity)

### Input objects using this input

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