Customer Address APIs adopt ISO countryCode; territoryCode deprecated in 2026-10
CustomerAddressInput and CustomerAddress gain a countryCode field taking ISO 3166-1 alpha-2 values (US, CA) across the Customer Account API and Checkout UI surfaces, effective September 8, 2026. The existing territoryCode field is deprecated in API version 2026-10 but keeps working with no removal deadline announced. Apps adopting 2026-10 should switch address reads/writes to countryCode and retest address flows.
Read the official Shopify source01 · Source fact
What changed
CustomerAddressInput and CustomerAddress gain a countryCode field taking ISO 3166-1 alpha-2 values (US, CA) across the Customer Account API and Checkout UI surfaces, effective September 8, 2026. The existing territoryCode field is deprecated in API version 2026-10 but keeps working with no removal deadline announced. Apps adopting 2026-10 should switch address reads/writes to countryCode and retest address flows.
- Published
- Sep 11, 2026
- Effective
- 2026-09-08
- Deadline
- No explicit deadline stated
02 · Business impact
Who and what may be affected
- Operators
- Agency, Seller
- Surfaces
- Customer Account Api, Checkout Ui
- Impact
- Technical, Operations
- Settlement categories
- No direct payout category identified
03 · Next action
What to check
When upgrading to 2026-10, replace territoryCode references with countryCode (alpha-2 values) in address integrations and retest customer address operations.