---
title: CartDeliveryAddressesReplacePayload - Storefront API
description: Return type for `cartDeliveryAddressesReplace` mutation.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/CartDeliveryAddressesReplacePayload
  md: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/CartDeliveryAddressesReplacePayload.md
api_name: storefront
api_type: graphql
type: payload
---

# Cart​Delivery​Addresses​Replace​Payload

payload

Return type for `cartDeliveryAddressesReplace` mutation.

## Fields

* 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.

***

## Mutations with this payload

* [cart​Delivery​Addresses​Replace](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace)

  mutation

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

  * cart​Id

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

    required

    ### Arguments

    The ID of the cart.

  * 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.

  ***

***

## Map

### Mutations with this payload

* [cart​Delivery​Addresses​Replace](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace)