---
title: Cart Delivery Address Management - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/cart-delivery-address-management'
  md: 'https://shopify.dev/changelog/cart-delivery-address-management.md'
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2024-12-09T11:15:37-05:00'
  postedAt: '2025-01-01T00:00:00-05:00'
  updatedAt: '2024-12-19T14:05:24-05:00'
  effectiveAt: '2025-01-01T00:00:00-05:00'
---

January 1, 2025

Tags:

* Action Required
* Storefront GraphQL API
* 2025-01

# Cart Delivery Address Management

We've refined and improved how delivery addresses are handled by making `deliveryAddresses` a required input field within a new delivery object.

As of API version 2025-01, the [`deliveryAddressPreferences`](https://shopify.dev/docs/api/storefront/2025-01/objects/CartBuyerIdentity#field-deliveryaddresspreferences) field on the `CartBuyerIdentity` object is deprecated. Use the new [`addresses`](https://shopify.dev/docs/api/storefront/2025-01/objects/CartDelivery#field-addresses) field on the `CartDelivery` object instead.

We've added the following new mutations for managing delivery addresses on carts:

* [`cartDeliveryAddressesAdd`](https://shopify.dev/docs/api/storefront/2025-01/mutations/cartDeliveryAddressesAdd)
* [`cartDeliveryAddressesUpdate`](https://shopify.dev/docs/api/storefront/2025-01/mutations/cartDeliveryAddressesUpdate)
* [`cartDeliveryAddressesRemove`](https://shopify.dev/docs/api/storefront/2025-01/mutations/cartDeliveryAddressesRemove)

For cart delivery addresses, you can set an address as `selected` to indicate that delivery rates should be calculated. This improves performance by avoiding unnecessary rate generation. It also ensures that addresses are synchronized between Checkout and Cart, maintaining a single source of truth for any updates or changes.

We recommend reviewing your current integration and preparing to adopt the new field and mutations.