---
title: customerAddressUpdate - Customer API
description: Updates a specific address for a customer.
api_version: 2025-10
api_name: customer
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/mutations/customeraddressupdate
  md: https://shopify.dev/docs/api/customer/latest/mutations/customeraddressupdate.md
---

# customer​Address​Update

mutation

Updates a specific address for a customer.

## Arguments

* address

  [Customer​Address​Input](https://shopify.dev/docs/api/customer/latest/input-objects/CustomerAddressInput)

  Specifies the fields to use when updating the address.

* address​Id

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

  required

  The ID of the address to be updated.

* default​Address

  [Boolean](https://shopify.dev/docs/api/customer/latest/scalars/Boolean)

  Default:null

  The flag to set the address as the default address.

***

## Customer​Address​Update​Payload returns

* customer​Address

  [Customer​Address](https://shopify.dev/docs/api/customer/latest/objects/CustomerAddress)

  The updated address.

* user​Errors

  [\[User​Errors​Customer​Address​User​Errors!\]!](https://shopify.dev/docs/api/customer/latest/objects/UserErrorsCustomerAddressUserErrors)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### customerAddressUpdate reference

## Mutation Reference

```graphql
mutation customerAddressUpdate($addressId: ID!, $address: CustomerAddressInput, $defaultAddress: Boolean) {
  customerAddressUpdate(addressId: $addressId, address: $address, defaultAddress: $defaultAddress) {
    customerAddress {
      # CustomerAddress fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "addressId": "gid://shopify/<objectName>/10079785100",
  "address": {
    "firstName": "<your-firstName>",
    "lastName": "<your-lastName>",
    "address1": "<your-address1>",
    "address2": "<your-address2>",
    "city": "<your-city>",
    "company": "<your-company>",
    "territoryCode": "<your-territoryCode>",
    "phoneNumber": "<your-phoneNumber>",
    "zoneCode": "<your-zoneCode>",
    "zip": "<your-zip>"
  },
  "defaultAddress": true
}
```