Removing marketCurrencySettingsUpdate mutation
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 22, 2026.
This Shopify update is categorized as Action Required, API, Breaking API Change, GraphQL Admin API, 2027-01.
What changed
In API version 2027-01, the Admin GraphQL API removes: marketCurrencySettingsUpdate MarketCurrencySettingsUpdatePayload MarketCurrencySettingsUserError MarketCurrencySettingsUserErrorCode The mutation was deprecated when Markets Home launched in version 2025-04. Since 2025-04 became inaccessible, every call has returned the UNIFIED_MARKETS_ENABLED user error instead of updating anything. To create or update market currency settings, use marketCreate and marketUpdate. Both accept currency settings directly, so you don't need a separate call. Versions 2026-10 and earlier are unaffected and keep the mutation for the remainder of their supported lifetime.
Who is affected
You're affected if your app still calls marketCurrencySettingsUpdate. Those calls aren't updating currency settings today, and in 2027-01 they'll fail differently: the field no longer exists, so the request is rejected at validation. You're not affected if you already use marketCreate and marketUpdate to manage market currency settings.
What action may be needed
Replace any remaining calls to marketCurrencySettingsUpdate: Use marketCreate when you create a market and its currency settings. Use marketUpdate when you change the currency settings of an existing market. Pass the same currency settings directly in the marketCreate or marketUpdate input. Because a request that references a removed field fails validation, an unmigrated call in 2027-01 fails the entire request rather than returning a user error for one mutation.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →