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

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

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.