---
title: MarketUserError - GraphQL Admin
description: Defines errors encountered while managing a Market.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/marketusererror
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/marketusererror.md
---

# Market​User​Error

object

Requires `read_markets` for queries and both `read_markets` as well as `write_markets` for mutations.

Defines errors encountered while managing a Market.

## Fields

* code

  [Market​User​Error​Code](https://shopify.dev/docs/api/admin-graphql/latest/enums/MarketUserErrorCode)

  The error code.

* field

  [\[String!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The path to the input field that caused the error.

* message

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [backup​Region​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/backupRegionUpdate)

  mutation

  Update the backup region that is used when we have no better signal of what region a buyer is in.

* [market​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketCreate)

  mutation

  Creates a new market.

* [market​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketDelete)

  mutation

  Deletes a market definition.

* [market​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketUpdate)

  mutation

  Updates the properties of a market.

* [web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceCreate)

  mutation

  Creates a web presence.

* [web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceDelete)

  mutation

  Deletes a web presence.

* [web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceUpdate)

  mutation

  Updates a web presence.

### Deprecated mutations

* [market​Region​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketRegionDelete)

  mutation

  Deprecated

* [market​Regions​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketRegionsCreate)

  mutation

  Deprecated

* [market​Regions​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketRegionsDelete)

  mutation

  Deprecated

* [market​Web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceCreate)

  mutation

  Deprecated

* [market​Web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceDelete)

  mutation

  Deprecated

* [market​Web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketWebPresenceUpdate)

  mutation

  Deprecated

***

## <\~> MarketUserError Mutations

### Mutated by

* <\~>[backup​Region​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/backupRegionUpdate)
* <\~>[market​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketCreate)
* <\~>[market​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketDelete)
* <\~>[market​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/marketUpdate)
* <\~>[web​Presence​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceCreate)
* <\~>[web​Presence​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceDelete)
* <\~>[web​Presence​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/webPresenceUpdate)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)

  interface

***

## ||-MarketUserError Implements

### Implements

* ||-[Displayable​Error](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DisplayableError)