---
title: CartPreferencesInput - Storefront API
description: >-
  The input fields represent preferences for the buyer that is interacting with
  the cart.
api_version: 2026-07
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/input-objects/CartPreferencesInput
  md: >-
    https://shopify.dev/docs/api/storefront/latest/input-objects/CartPreferencesInput.md
api_name: storefront
api_type: graphql
type: input-object
---

# Cart​Preferences​Input

input\_object

The input fields represent preferences for the buyer that is interacting with the cart.

## Fields

* delivery

  [Cart​Delivery​Preference​Input](https://shopify.dev/docs/api/storefront/latest/input-objects/CartDeliveryPreferenceInput)

  Delivery preferences can be used to prefill the delivery section in at checkout.

* wallet

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

  Wallet preferences are used to populate relevant payment fields in the checkout flow. Accepted value: `["shop_pay"]`.

  The input must not contain more than `250` values.

***

## Input objects using this input

* [Cart​Buyer​Identity​Input.preferences](https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput#fields-preferences)

  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/current/mutations/cartCreate) and [`cartBuyerIdentityUpdate`](https://shopify.dev/docs/api/storefront/current/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.

  ***

***

## Map

### Input objects using this input

* [Cart​Buyer​Identity​Input.preferences](https://shopify.dev/docs/api/storefront/latest/input-objects/CartBuyerIdentityInput#fields-preferences)