---
title: >-
  Deprecation of Shop.billingAddress in favor of Shop.shopAddress - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress
  md: >-
    https://shopify.dev/changelog/deprecation-of-shop-billingaddress-in-favor-of-shop-shopaddress.md
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2025-11-04T07:53:58-05:00'
  postedAt: '2025-12-22T12:00:00-05:00'
  updatedAt: '2025-12-18T05:03:47-05:00'
  effectiveAt: '2025-12-01T12:00:00-05:00'
---

December 22, 2025

Tags:

* Action Required
* Admin GraphQL API
* 2026-01

# Deprecation of `Shop.billingAddress` in favor of `Shop.shopAddress`

As of API version 2026-01, the [`shopAddress` field will be introduced to the `Shop` object](https://shopify.dev/docs/api/admin-graphql/2026-01/objects/shop#field-Shop.fields.shopAddress) in the GraphQL Admin API. This new field replaces the now-deprecated `billingAddress` field, which will be removed in a future version. `shopAddress` will have identical structure and values as `billingAddress`.

Billing account address currently corresponds to the shop address. This change makes that relationship clearer, and supports potential future separation of billing and shop addresses.

### Action required

You should update your queries to use the new `shopAddress` field when accessing the `Shop` object in the GraphQL Admin API. Replace instances of `shop { billingAddress { ... } }` with `shop { shopAddress { ... } }`.

For example, update your query from:

```graphql
query ShopAddress {
  shop {
    billingAddress {
      address1
      address2
      city
      province
      zip
      country
    }
  }
}
```

to:

```graphql
query ShopAddress {
  shop {
    shopAddress {
      address1
      address2
      city
      province
      zip
      country
    }
  }
}
```

By making these changes, you ensure compatibility with future API versions.