---
title: cartDeliveryAddressesReplace - Storefront API
description: >
  Replaces all delivery addresses on a
  [`Cart`](/docs/api/storefront/2026-01/objects/Cart) with a new set of
  addresses in a single operation. Unlike
  [`cartDeliveryAddressesUpdate`](/docs/api/storefront/2026-01/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-01
api_name: storefront
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace
  md: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace.md
---

# cart​Delivery​Addresses​Replace

mutation

Replaces all delivery addresses on a [`Cart`](https://shopify.dev/docs/api/storefront/2026-01/objects/Cart) with a new set of addresses in a single operation. Unlike [`cartDeliveryAddressesUpdate`](https://shopify.dev/docs/api/storefront/2026-01/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