Choose a version:

cartDeliveryAddressesUpdate

mutation

Updates one or more delivery addresses on a cart.

Arguments

Anchor to addressesaddresses •[CartSelectableAddressUpdateInput!]! required: The delivery addresses to update.

The input must not contain more than 250 values.
Anchor to cartIdcartId •ID! required: The ID of the cart.

Was this section helpful?

Anchor to CartDeliveryAddressesUpdatePayload returnsCartDeliveryAddressesUpdatePayload returns

Anchor to cartcart •Cart: The updated cart.
Anchor to userErrorsuserErrors •[CartUserError!]! non-null: The list of errors that occurred from executing the mutation.
Anchor to warningswarnings •[CartWarning!]! non-null: A list of warnings that occurred during the mutation.

Was this section helpful?

Updates a delivery address on a cart
cartDeliveryAddressesUpdate reference

Examples

Open in GraphiQL

const { storefront } = await unauthenticated.storefront(

'your-development-store.myshopify.com'

);

const response = await storefront.graphql(

`#graphql

mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {

cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {

userErrors {

message

code

field

}

warnings {

message

code

target

}

cart {

delivery {

addresses {

selected

oneTimeUse

address {

... on CartDeliveryAddress {

firstName

lastName

company

address1

address2

city

provinceCode

zip

countryCode

}

}`,

{

variables: {

"id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",

"addresses": [

{

"id": "gid://shopify/CartSelectableAddress/delivery-address-1",

"selected": true,

"address": {

"copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"

}

]

);

const data = await response.json();

mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {
  cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {
    userErrors {
      message
      code
      field
    }
    warnings {
      message
      code
      target
    }
    cart {
      id
      delivery {
        addresses {
          id
          selected
          oneTimeUse
          address {
            ... on CartDeliveryAddress {
              firstName
              lastName
              company
              address1
              address2
              city
              provinceCode
              zip
              countryCode
            }
          }
        }
      }
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/api/2025-07/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \
-d '{
"query": "mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) { cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) { userErrors { message code field } warnings { message code target } cart { id delivery { addresses { id selected oneTimeUse address { ... on CartDeliveryAddress { firstName lastName company address1 address2 city provinceCode zip countryCode } } } } } } }",
 "variables": {
    "id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",
    "addresses": [
      {
        "id": "gid://shopify/CartSelectableAddress/delivery-address-1",
        "selected": true,
        "address": {
          "copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"
        }
      }
    ]
  }
}'

const { storefront } = await unauthenticated.storefront(
  'your-development-store.myshopify.com'
);

const response = await storefront.graphql(
  `#graphql
  mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {
    cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {
      userErrors {
        message
        code
        field
      }
      warnings {
        message
        code
        target
      }
      cart {
        id
        delivery {
          addresses {
            id
            selected
            oneTimeUse
            address {
              ... on CartDeliveryAddress {
                firstName
                lastName
                company
                address1
                address2
                city
                provinceCode
                zip
                countryCode
              }
            }
          }
        }
      }
    }
  }`,
  {
    variables: {
      "id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",
      "addresses": [
        {
          "id": "gid://shopify/CartSelectableAddress/delivery-address-1",
          "selected": true,
          "address": {
            "copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"
          }
        }
      ]
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Storefront({
  domain: 'your-development-store.myshopify.com',
  storefrontAccessToken,
});
const data = await client.query({
  data: {
    "query": `mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {
      cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {
        userErrors {
          message
          code
          field
        }
        warnings {
          message
          code
          target
        }
        cart {
          id
          delivery {
            addresses {
              id
              selected
              oneTimeUse
              address {
                ... on CartDeliveryAddress {
                  firstName
                  lastName
                  company
                  address1
                  address2
                  city
                  provinceCode
                  zip
                  countryCode
                }
              }
            }
          }
        }
      }
    }`,
    "variables": {
      "id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",
      "addresses": [
        {
          "id": "gid://shopify/CartSelectableAddress/delivery-address-1",
          "selected": true,
          "address": {
            "copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"
          }
        }
      ]
    },
  },
});

Input variables

JSON

{

"id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",

"addresses": [

{

"id": "gid://shopify/CartSelectableAddress/delivery-address-1",

"selected": true,

"address": {

"copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"

}

]

}

Response

JSON

{

"cartDeliveryAddressesUpdate": {

"userErrors": [],

"warnings": [],

"cart": {

"id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",

"delivery": {

"addresses": [

{

"id": "gid://shopify/CartSelectableAddress/delivery-address-1",

"selected": true,

"oneTimeUse": true,

"address": {

"firstName": "Bob",

"lastName": "Bobsen",

"company": null,

"address1": "123 Amoebobacterieae St",

"address2": null,

"city": "Ottawa",

"provinceCode": "ON",

"zip": "K2P0V6",

"countryCode": "CA"

}

]

}