Customer Address APIs now support countryCode
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 08, 2026.
This Shopify update is categorized as API, Deprecation announcement, Checkout UI, Customer Account API, Customer Accounts, 2026-10.
What changed
The CustomerAddressInput input object and CustomerAddress object now include countryCode. Use countryCode when creating, updating, or reading a customer address. It uses the CountryCode enum and accepts ISO 3166-1 alpha-2 country codes such as US or CA. The existing territoryCode field is marked as deprecated in API version 2026-10. Note: territoryCode has not been removed.
Who is 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.
What action may be needed
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.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →