---
title: >-
  The cartDeliveryAddressesUpdate mutation now supports removing all addresses
  from a cart - 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/the-cartdeliveryaddressesupdate-mutation-now-supports-removing-all-addresses-from-a-cart
  md: >-
    https://shopify.dev/changelog/posts/the-cartdeliveryaddressesupdate-mutation-now-supports-removing-all-addresses-from-a-cart.md
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: Storefront API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-04-16T14:39:32-04:00'
  postedAt: '2025-08-08T12:00:00-04:00'
  updatedAt: '2025-08-13T10:02:31-04:00'
  effectiveAt: '2025-04-17T12:00:00-04:00'
---

August 8, 2025

# The `cartDeliveryAddressesUpdate` mutation now supports removing all addresses from a cart

DateAugust 8, 2025

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

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

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

To clear all delivery addresses associated with a cart, you can now call the [`cartDeliveryAddressesUpdate` mutation](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesUpdate) and set `addresses` to an empty array(`[]`).

Previously, to clear a cart’s addresses, you could call the [`cartBuyerIdentityUpdate` mutation](https://shopify.dev/docs/api/storefront/2025-04/mutations/cartBuyerIdentityUpdate) and set `buyerIdentity.deliveryAddressPreferences` to an empty array. However, `deliveryAddressPreferences` is deprecated.

**Action required before API version 2025-10**

Review your existing code. Starting with API version 2025-10, setting the `addresses` field of the `cartDeliveryAddressesUpdate` mutation to an empty array (`[]`) clears cart addresses. If you do not want this behavior, update your code.