---
title: UserError - Storefront API
description: Represents an error in the input of a mutation.
api_version: 2024-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/2024-10/objects/UserError'
  md: 'https://shopify.dev/docs/api/storefront/2024-10/objects/UserError.txt'
---

# User​Error

object

Represents an error in the input of a mutation.

## Fields

* field

  [\[String!\]](https://shopify.dev/docs/api/storefront/2024-10/scalars/String)

  The path to the input field that caused the error.

* message

  [String!](https://shopify.dev/docs/api/storefront/2024-10/scalars/String)

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [customer​Access​Token​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenCreate)

  mutation

  Creates a customer access token. The customer access token is required to modify the customer object in any way.

* [customer​Access​Token​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenDelete)

  mutation

  Permanently destroys a customer access token.

* [customer​Access​Token​Renew](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenRenew)

  mutation

  Renews a customer access token.

  Access token renewal must happen *before* a token expires. If a token has already expired, a new one should be created instead via `customerAccessTokenCreate`.

* [customer​Activate](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerActivate)

  mutation

  Activates a customer.

* [customer​Address​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressCreate)

  mutation

  Creates a new address for a customer.

* [customer​Address​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressDelete)

  mutation

  Permanently deletes the address of an existing customer.

* [customer​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressUpdate)

  mutation

  Updates the address of an existing customer.

* [customer​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerCreate)

  mutation

  Creates a new customer.

* [customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerDefaultAddressUpdate)

  mutation

  Updates the default address of an existing customer.

* [customer​Recover](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerRecover)

  mutation

  Sends a reset password email to the customer. The reset password email contains a reset password URL and token that you can pass to the [`customerResetByUrl`](https://shopify.dev/api/storefront/latest/mutations/customerResetByUrl) or [`customerReset`](https://shopify.dev/api/storefront/latest/mutations/customerReset) mutation to reset the customer password.

  This mutation is throttled by IP. With private access, you can provide a [`Shopify-Storefront-Buyer-IP`](https://shopify.dev/api/usage/authentication#optional-ip-header) instead of the request IP. The header is case-sensitive and must be sent as `Shopify-Storefront-Buyer-IP`.

  Make sure that the value provided to `Shopify-Storefront-Buyer-IP` is trusted. Unthrottled access to this mutation presents a security risk.

* [customer​Reset](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerReset)

  mutation

  "Resets a customer’s password with the token received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation."

* [customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerResetByUrl)

  mutation

  "Resets a customer’s password with the reset password URL received from a reset password email. You can send a reset password email with the [`customerRecover`](https://shopify.dev/api/storefront/latest/mutations/customerRecover) mutation."

* [customer​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerUpdate)

  mutation

  Updates an existing customer.

***

## <\~> UserError Mutations

### Mutated by

* <\~>[customer​Access​Token​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenCreate)
* <\~>[customer​Access​Token​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenDelete)
* <\~>[customer​Access​Token​Renew](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAccessTokenRenew)
* <\~>[customer​Activate](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerActivate)
* <\~>[customer​Address​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressCreate)
* <\~>[customer​Address​Delete](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressDelete)
* <\~>[customer​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerAddressUpdate)
* <\~>[customer​Create](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerCreate)
* <\~>[customer​Default​Address​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerDefaultAddressUpdate)
* <\~>[customer​Recover](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerRecover)
* <\~>[customer​Reset](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerReset)
* <\~>[customer​Reset​By​Url](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerResetByUrl)
* <\~>[customer​Update](https://shopify.dev/docs/api/storefront/2024-10/mutations/customerUpdate)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/storefront/2024-10/interfaces/DisplayableError)

  interface

***

## ||-UserError Implements

### Implements

* ||-[Displayable​Error](https://shopify.dev/docs/api/storefront/2024-10/interfaces/DisplayableError)