Shop.billingAddress deprecated in favor of Shop.shopAddress in the Admin API
API version 2026-01 introduces Shop.shopAddress and deprecates Shop.billingAddress ahead of a future removal; both fields currently return the same address values.
Read the official Shopify source01 · Source fact
What changed
API version 2026-01 introduces Shop.shopAddress and deprecates Shop.billingAddress ahead of a future removal; both fields currently return the same address values.
- Published
- Dec 22, 2025
- Effective
- API version 2026-01
- Deadline
- No explicit deadline stated
02 · Business impact
Who and what may be affected
- Operators
- Agency, Bookkeeper
- Surfaces
- Admin Api
- Impact
- Technical, Reporting
- Settlement categories
- No direct payout category identified
03 · Next action
What to check
Replace Shop.billingAddress with Shop.shopAddress in queries that stamp the shop address onto invoices or reports before the deprecated field is removed.
confirmed source relationshipLast reviewed Jul 26, 2026