---
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/posts/cart-delivery-address-management'
  md: 'https://shopify.dev/changelog/posts/cart-delivery-address-management.md'
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Storefront API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  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

# Cart Delivery Address Management

DateJanuary 1, 2025

Version[2025-01](https://shopify.dev/changelog?api_version=2025-01)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Storefront API](https://shopify.dev/changelog?api_type=storefront-graphql)

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.