Brief
Shopify Customer Address APIs Add countryCode, Deprecate territoryCode
Shopify's Customer Account API version 2026-10 now supports countryCode for customer addresses, deprecating the existing territoryCode field while keeping it fully supported.
The change affects apps using the Customer Account API to create, update, or read customer addresses. Starting with API version 2026-10, the CustomerAddressInput input object and CustomerAddress object include countryCode, which uses the CountryCode enum and accepts ISO 3166-1 alpha-2 codes like US or CA. The existing territoryCode field is marked as deprecated but has not been removed, and existing queries and mutations continue to work as before, including integrations using older API versions.
When adopting API version 2026-10, developers should check customer address queries and mutations for uses of territoryCode and replace them with countryCode. If both fields are supplied in an address input, countryCode takes precedence. Apps using API version 2026-07 or earlier are unchanged and can continue using territoryCode. No immediate disruption is expected, and no removal version has been announced.
Our reading
Our reading is that this is a low-risk migration for developers, as existing integrations continue to work, but teams adopting the new API version should update their code to use countryCode to align with Shopify's broader API conventions.
Source details and supporting facts
Each line is stated by the page named above it.
Stated by shopify.dev
- Customer Address APIs now support countryCode.
- Starting with Customer Account API 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.
- If both fields are supplied in an address input, countryCode takes precedence.
- countryCode uses the CountryCode enum and accepts ISO 3166-1 alpha-2 country codes such as US or CA.
- No immediate change is required for apps using API version 2026-07 or earlier.
Sources
- Shopify developer changelogText stored 16 September 2026
How this story was checked. Written from the 1 page listed above, stored 16 September 2026; claims checked against that stored text on 16 September 2026.
What that means
- 6 of 6 reported statements were confirmed against the page that carries them; the rest were removed rather than published.
- Figures in the text were required to appear in the stored source text: yes. Identifiers: yes.
- The check reads stored text only: no claim rests on a fresh look that did not happen.
- Where the reporting was silent, the text says so instead of filling the gap.