---
title: cartDeliveryAddressesReplace - Storefront API
description: >-
  Replaces all delivery addresses on a

  [`Cart`](/docs/api/storefront/2026-10/objects/Cart) with a

  new set of addresses in a single operation. Unlike
  [`cartDeliveryAddressesUpdate`](/docs/api/storefront/2026-10/mutations/cartDeliveryAddressesUpdate),

  which modifies existing addresses, this mutation removes all current addresses

  and sets the provided list as the new delivery addresses.


  One address can be marked as selected, and each address can be flagged for

  one-time use or configured with a specific validation strategy.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace
  md: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace.md
api_name: storefront
api_type: graphql
type: mutation
---

# cart​Delivery​Addresses​Replace

mutation

Replaces all delivery addresses on a [`Cart`](https://shopify.dev/docs/api/storefront/2026-10/objects/Cart) with a new set of addresses in a single operation. Unlike [`cartDeliveryAddressesUpdate`](https://shopify.dev/docs/api/storefront/2026-10/mutations/cartDeliveryAddressesUpdate), which modifies existing addresses, this mutation removes all current addresses and sets the provided list as the new delivery addresses.

One address can be marked as selected, and each address can be flagged for one-time use or configured with a specific validation strategy.

## Arguments

* addresses

  [\[Cart​Selectable​Address​Input!\]!](https://shopify.dev/docs/api/storefront/latest/input-objects/CartSelectableAddressInput)

  required

  A list of delivery addresses to replace on the cart.

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

* cart​Id

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

  required

  The ID of the cart.

***

## Cart​Delivery​Addresses​Replace​Payload returns

* cart

  [Cart](https://shopify.dev/docs/api/storefront/latest/objects/Cart)

  The updated cart.

* user​Errors

  [\[Cart​User​Error!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CartUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* warnings

  [\[Cart​Warning!\]!](https://shopify.dev/docs/api/storefront/latest/objects/CartWarning)

  non-null

  A list of warnings that occurred during the mutation.

***

## Examples

* ### cartDeliveryAddressesReplace reference