---
title: New Catalog APIs - 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/new-catalog-apis'
  md: 'https://shopify.dev/changelog/new-catalog-apis.md'
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2025-01-28T06:58:26-05:00'
  postedAt: '2025-01-29T12:00:00-05:00'
  updatedAt: '2025-08-20T09:57:47-04:00'
  effectiveAt: '2025-01-29T12:00:00-05:00'
---

January 29, 2025

Tags:

* Action Required
* Admin GraphQL API
* 2025-04

# New Catalog APIs

As of April 2025, the Catalog APIs have been updated to support changes in how markets are managed. For more details, see the [New Markets APIs](https://shopify.dev/changelog/new-markets-apis).

With these updates, multiple markets can now be assigned to a single catalog. Consequently, the [`MarketCatalog.markets`](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/MarketCatalog#connection-markets) connection will no longer guarantee the return of a single entry.

Additionally, the `Market` object now supports new conditions. Previously, only `RegionConditions` were available for a market; now, `CompanyLocationConditions` are also supported. To maintain the existing behavior and access only `Regions`, you must update the `markets` connection by using the `type: REGION` argument.

Example:

```graphql
markets(first: 10, type: REGION) {
    nodes {
      id
    }
  }
}
```