---
title: CartDeliveryPreference - Storefront API
description: |
  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.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/cartdeliverypreference
  md: https://shopify.dev/docs/api/storefront/latest/objects/cartdeliverypreference.md
---

# Cart​Delivery​Preference

object

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.

## Fields

* coordinates

  [Cart​Delivery​Coordinates​Preference](https://shopify.dev/docs/api/storefront/latest/objects/CartDeliveryCoordinatesPreference)

  Preferred location used to find the closest pick up point based on coordinates.

* delivery​Method

  [\[Preference​Delivery​Method​Type!\]!](https://shopify.dev/docs/api/storefront/latest/enums/PreferenceDeliveryMethodType)

  non-null

  The preferred delivery methods such as shipping, local pickup or through pickup points.

* pickup​Handle

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

  non-null

  The pickup handle prefills checkout fields with the location for either local pickup or pickup points delivery methods. It accepts both location ID for local pickup and external IDs for pickup points.

***

## Map

### Fields with this object

* {}[CartPreferences.delivery](https://shopify.dev/docs/api/storefront/latest/objects/CartPreferences#field-CartPreferences.fields.delivery)