---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

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.