# CartBuyerIdentityInput - storefront - INPUT_OBJECT Version: unstable ## 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. ### Access Scopes ## Fields * [companyLocationId](/docs/api/storefront/unstable/scalars/ID): ID - The company location of the buyer that is interacting with the cart. * [countryCode](/docs/api/storefront/unstable/enums/CountryCode): CountryCode - The country where the buyer is located. * [customerAccessToken](/docs/api/storefront/unstable/scalars/String): String - The access token used to identify the customer associated with the cart. * [deliveryAddressPreferences](/docs/api/storefront/unstable/input-objects/DeliveryAddressInput): DeliveryAddressInput - An ordered set of delivery addresses tied to the buyer that is interacting with the cart. The rank of the preferences is determined by the order of the addresses in the array. Preferences can be used to populate relevant fields in the checkout flow. As of the `2025-01` release, `buyerIdentity.deliveryAddressPreferences` is deprecated. Delivery addresses are now part of the `CartDelivery` object and managed with three new mutations: - `cartDeliveryAddressAdd` - `cartDeliveryAddressUpdate` - `cartDeliveryAddressDelete` The input must not contain more than `250` values. * [email](/docs/api/storefront/unstable/scalars/String): String - The email address of the buyer that is interacting with the cart. * [phone](/docs/api/storefront/unstable/scalars/String): String - The phone number of the buyer that is interacting with the cart. * [preferences](/docs/api/storefront/unstable/input-objects/CartPreferencesInput): 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. ## Input objects with this input object * [CartInput](/docs/api/storefront/unstable/input-objects/CartInput) * [cartBuyerIdentityUpdate](/docs/api/storefront/unstable/mutations/cartBuyerIdentityUpdate) ## Examples