Customer Address APIs now support countryCode

What Changed

Shopify has added countryCode support to the Customer Account API, starting with API version 2026-10. This update affects two key GraphQL objects: CustomerAddressInput and CustomerAddress. Both now include a countryCode field that developers can use when creating, updating, or reading customer address data.

The previously used territoryCode field is now deprecated, but Shopify confirms it remains fully supported. This means existing integrations built on territoryCode will continue to function without breaking changes, even after the deprecation notice.

Why This Matters for Shopify App Developers

For developers building or maintaining apps that interact with customer address data, this change signals a shift in Shopify’s data model naming conventions. countryCode aligns more closely with standard ISO country code terminology used across other Shopify APIs and broader e-commerce systems, potentially reducing confusion for developers integrating multiple data sources.

Apps handling checkout flows, address validation, shipping calculations, or customer profile management through the Customer Account API should take note. Any new development targeting API version 2026-10 or later should adopt countryCode directly rather than building on the deprecated field.

Practical Implications

Developers should audit existing codebases that reference territoryCode in customer address mutations or queries. While no immediate action is required since backward compatibility is maintained, planning a migration path is recommended before deprecated fields are potentially removed in future API versions.

Teams building new integrations or upgrading to API version 2026-10 should default to countryCode from the start. Testing address creation and update flows after migration is advisable to confirm consistent behavior across storefronts and admin-facing tools.

Monitor Shopify’s changelog for further deprecation timelines related to territoryCode.

Read the full announcement →