Reported details
What happened
Shopify’s official Developer Changelog says Customer Account API version 2026-10 adds countryCode to CustomerAddressInput and CustomerAddress for creating, updating, and reading customer addresses.
countryCode uses Shopify’s CountryCode enum and ISO 3166-1 alpha-2 values such as US or CA; territoryCode is deprecated in version 2026-10 but remains supported.
Apps using API version 2026-07 or earlier are unchanged, and the changelog says no removal version has been announced. If both fields are supplied, countryCode takes precedence.
Business relevance
Why it matters
For North American apps that manage customer addresses, the update gives a clearer migration path to Shopify’s country-code terminology while preserving existing territoryCode integrations for now.
The main risk is version-specific behavior: countryCode becomes the preferred field when an app adopts API version 2026-10, so address logic should not assume older and newer API versions behave identically.
Editorial perspective
Analysis & judgment
This is a compatibility update rather than an immediate outage trigger. Merchants whose apps remain on API version 2026-07 or earlier have no stated requirement to change, while teams planning a 2026-10 upgrade should treat address fields as part of their release review.
Because countryCode takes precedence when both fields are supplied, a partial migration could produce different results from legacy territoryCode data. Teams should decide which field is authoritative before sending both during a transition.
Applicability
Seller impact
North American merchants using custom apps or integrations that create, update, or read customer addresses may need developer review before moving to Customer Account API 2026-10.
Merchants using an app that manages addresses but does not control its API version may have no immediate task; the relevant dependency is whether that app adopts version 2026-10 or later.
Action plan
What to do now
- 1
Inventory address-field usage
this-weekAsk developers or app vendors whether Customer Address API queries and mutations use territoryCode and which Customer Account API version they target. Prioritize integrations serving North American storefront operations.
- 2
Plan the countryCode migration with the next API upgrade
monitorWhen adopting version 2026-10 or later, replace territoryCode with countryCode, validate alpha-2 values such as US or CA, and test address creation, updates, and reads before release.
What not to do yet
- Do not rush an emergency change solely because territoryCode is deprecated: the supplied Shopify changelog says it remains supported, older API versions are unchanged, and no removal version has been announced.
Sources & context
Evidence and sources
A source may provide only a headline or summary. Read the evidence scope below. Links and workflow checks are not independent fact verification. Internal confidence values are workflow signals, not probabilities of factual correctness.
- 01Source link
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. Developers should migrate to countryCode when adopting API version 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. 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
Shopify Developer Changelog · Workflow status: single-source
Retrieved: September 8, 2026 at 04:07 p.m. UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.