---
title: Customer Address APIs now support countryCode - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/customer-address-apis-now-support-countrycode'
  md: >-
    https://shopify.dev/changelog/customer-address-apis-now-support-countrycode.md
metadata:
  effectiveApiVersion: 2026-10
  affectedApi:
    - displayName: Checkout UI
      handle: checkout-ui-api
    - displayName: Customer Account API
      handle: customer-account-graphql
    - displayName: Customer Accounts
      handle: customer-accounts
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: false
  createdAt: '2026-08-26T11:57:36-04:00'
  postedAt: '2026-09-08T12:00:00-04:00'
  updatedAt: '2026-09-04T17:13:35-04:00'
  effectiveAt: '2026-09-08T12:00:00-04:00'
---

# Customer Address APIs now support countryCode

DateSeptember 8, 2026

Version[2026-10](https://shopify.dev/changelog?api_version=2026-10)

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)

SurfacesAPI

Affected APIs[Checkout UI](https://shopify.dev/changelog?api_type=checkout-ui-api)[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)[Customer Accounts](https://shopify.dev/changelog?api_type=customer-accounts)

Starting with [Customer Account API](https://shopify.dev/docs/api/customer) version 2026-10, customer address inputs and objects support `countryCode`. The existing `territoryCode` field is deprecated but remains fully supported, so current integrations continue working without interruption. Developers should migrate to `countryCode` when adopting API version 2026-10.

## What changed

The [`CustomerAddressInput`](https://shopify.dev/docs/api/customer/2026-10/input-objects/CustomerAddressInput#fields-countryCode) input object and [`CustomerAddress`](https://shopify.dev/docs/api/customer/2026-10/objects/CustomerAddress#field-CustomerAddress.fields.countryCode) object now include `countryCode`.

Use `countryCode` when creating, updating, or reading a customer address. It uses the [`CountryCode`](https://shopify.dev/docs/api/customer/2026-10/enums/CountryCode) enum and accepts ISO 3166-1 alpha-2 country codes such as `US` or `CA`.

The existing [`territoryCode`](https://shopify.dev/docs/api/customer/2026-10/input-objects/CustomerAddressInput#fields-territoryCode) field is marked as deprecated in API version 2026-10.

***

**Note:** \<code>\<span class="PreventFireFoxApplyingGapToWBR">territory\<wbr/>Code\</span>\</code> has not been removed. Existing queries and mutations that use it continue to work as before, including integrations using older API versions.

***

If both fields are supplied in an address input, `countryCode` takes precedence.

## Who’s affected

This change affects apps using the Customer Account API to create, update, or read customer addresses.

Apps using API version 2026-10 or later can use `countryCode` and will see `territoryCode` marked as deprecated. Apps using API version 2026-07 or earlier are unchanged and can continue using `territoryCode`.

There is no immediate disruption for existing clients, and no removal version has been announced.

## Why this matters

`countryCode` aligns customer addresses with the country-code terminology and strongly typed `CountryCode` enum used elsewhere in Shopify APIs. This provides clearer input requirements and avoids ambiguity between country and territory terminology.

## What to do

When adopting Customer Account API version 2026-10:

* Check customer address queries and mutations for uses of `territoryCode`.
* Replace those uses with `countryCode`.
* Supply ISO 3166-1 alpha-2 values, such as `US`, instead of alpha-3 or numeric values such as `USA` or `840`.
* Test customer address creation, updates, and reads against API version 2026-10.

No immediate change is required for apps that remain on an earlier API version. `territoryCode` continues to work in version 2026-10, but migrating prepares integrations for its possible removal in a future API version.

## Related docs

* [`CustomerAddress`](https://shopify.dev/docs/api/customer/2026-10/objects/CustomerAddress)
* [`CustomerAddressInput`](https://shopify.dev/docs/api/customer/2026-10/input-objects/CustomerAddressInput)
* [`CountryCode`](https://shopify.dev/docs/api/customer/2026-10/enums/CountryCode)