---
title: New Markets 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-markets-apis'
  md: 'https://shopify.dev/changelog/new-markets-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: '2024-12-16T16:45:54-05:00'
  postedAt: '2025-01-03T18:00:00-05:00'
  updatedAt: '2025-02-07T13:03:26-05:00'
  effectiveAt: '2025-01-03T18:00:00-05:00'
---

January 3, 2025

Tags:

* Action Required
* Admin GraphQL API
* 2025-04

# New Markets APIs

As of `2025-04`, the Markets APIs have been updated to support additional customizations and conditions for each market, enabling merchants to tailor their shops' buyer experiences.

### Primary Market

To transition away from the "primary market" concept, a new mutation, [`backupRegionUpdate`](https://shopify.dev/docs/api/admin-graphql/2025-04/mutations/backupRegionUpdate) allows you to set a shop-wide region to use when no better option can be determined from buyer signals. Instead of `MarketRegionCreateInput`, you must use [`BackupRegionUpdateInput`](https://shopify.dev/docs/api/admin-graphql/2025-04/input-objects/BackupRegionUpdateInput).

* To query the shop's backup region, use [`backupRegion`](https://shopify.dev/docs/api/admin-graphql/2025-04/queries/backupRegion).
* To obtain a list of available regions that can be set as a backup, use the [`availableBackupRegions`](https://shopify.dev/docs/api/admin-graphql/2025-04/queries/availableBackupRegions) query.

### Currency Settings

The [`Market.currencySettings`](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/Market#field-currencysettings) field is now nullable. A null value indicates that the currency settings are inherited from the parent market.

### Web Presence

A web presence can now exist without a market and can also be assigned to multiple markets. The field [`MarketWebPresence.market`](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/MarketWebPresence#field-market) is deprecated in favour of [`MarketWebPresence.markets`](https://shopify.dev/docs/api/admin-graphql/2025-04/objects/MarketWebPresence#connection-markets), which allows for this expanded functionality.

### Catalogs

As of `2025-04`, the Product's [contextualPricing](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Product#field-contextualpricing) field and Product Variant's [contextualPricing](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/ProductVariant#field-contextualpricing) field will resolve prices only considering active markets. Previous versions will continue to consider draft markets in the calculation of these fields.