---
title: UserError - GraphQL Admin
description: >-
  An error in the input of a mutation. Mutations return `UserError` objects to
  indicate validation failures, such as invalid field values or business logic
  violations, that prevent the operation from completing.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/UserError'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/UserError.md'
---

# User​Error

object

An error in the input of a mutation. Mutations return `UserError` objects to indicate validation failures, such as invalid field values or business logic violations, that prevent the operation from completing.

## Fields

* field
* message

***

## Map

### Fields with this object

* [AppFeedback.messages](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppFeedback#field-AppFeedback.fields.messages)
* [MarketingActivityExtensionAppErrors.userErrors](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketingActivityExtensionAppErrors#field-MarketingActivityExtensionAppErrors.fields.userErrors)
* [ProductDeleteOperation.userErrors](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDeleteOperation#field-ProductDeleteOperation.fields.userErrors)
* [ProductDuplicateOperation.userErrors](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductDuplicateOperation#field-ProductDuplicateOperation.fields.userErrors)

***

## Mutations

* appPurchaseOneTimeCreate
* appSubscriptionCancel
* appSubscriptionCreate
* appSubscriptionLineItemUpdate
* appUsageRecordCreate
* bulkOperationCancel
* collectionAddProducts
* collectionCreate
* collectionDelete
* collectionRemoveProducts
* collectionUpdate
* customerAddressCreate
* customerAddressDelete
* customerAddressUpdate
* customerAddTaxExemptions
* customerCreate
* customerDelete
* customerGenerateAccountActivationUrl
* customerPaymentMethodCreditCardCreate
* customerPaymentMethodCreditCardUpdate
* customerPaymentMethodRevoke
* customerPaymentMethodSendUpdateEmail
* customerRemoveTaxExemptions
* customerReplaceTaxExemptions
* customerUpdate
* customerUpdateDefaultAddress
* deliveryProfileCreate
* deliveryProfileRemove
* deliveryProfileUpdate
* deliveryPromiseParticipantsUpdate
* deliverySettingUpdate
* draftOrderBulkAddTags
* draftOrderBulkDelete
* draftOrderBulkRemoveTags
* draftOrderCalculate
* draftOrderComplete
* draftOrderCreate
* draftOrderCreateFromOrder
* draftOrderDelete
* draftOrderDuplicate
* draftOrderInvoicePreview
* draftOrderInvoiceSend
* draftOrderUpdate
* flowTriggerReceive
* fulfillmentCancel
* fulfillmentCreate
* fulfillmentEventCreate
* fulfillmentOrderAcceptCancellationRequest
* fulfillmentOrderAcceptFulfillmentRequest
* fulfillmentOrderCancel
* fulfillmentOrderClose
* fulfillmentOrderMove
* fulfillmentOrderOpen
* fulfillmentOrderRejectCancellationRequest
* fulfillmentOrderRejectFulfillmentRequest
* fulfillmentOrderSubmitCancellationRequest
* fulfillmentOrderSubmitFulfillmentRequest
* fulfillmentServiceCreate
* fulfillmentServiceDelete
* fulfillmentServiceUpdate
* fulfillmentTrackingInfoUpdate
* giftCardUpdate
* inventoryActivate
* inventoryDeactivate
* inventoryItemUpdate
* marketingActivityCreate
* marketingActivityUpdate
* metafieldsDelete
* orderCancel
* orderCapture
* orderClose
* orderEditAddCustomItem
* orderEditAddLineItemDiscount
* orderEditAddVariant
* orderEditBegin
* orderEditCommit
* orderEditSetQuantity
* orderMarkAsPaid
* orderOpen
* orderUpdate
* productBundleCreate
* productBundleUpdate
* productCreate
* productDelete
* productDuplicate
* productReorderMedia
* productUpdate
* publishablePublish
* publishablePublishToCurrentChannel
* publishableUnpublish
* publishableUnpublishToCurrentChannel
* refundCreate
* savedSearchCreate
* savedSearchDelete
* savedSearchUpdate
* scriptTagCreate
* scriptTagDelete
* scriptTagUpdate
* segmentCreate
* segmentDelete
* segmentUpdate
* shippingPackageDelete
* shippingPackageMakeDefault
* shippingPackageUpdate
* shopLocaleDisable
* shopLocaleEnable
* shopLocaleUpdate
* stagedUploadsCreate
* storefrontAccessTokenCreate
* storefrontAccessTokenDelete
* tagsAdd
* tagsRemove
* urlRedirectBulkDeleteAll
* webhookSubscriptionCreate
* webhookSubscriptionDelete
* webhookSubscriptionUpdate

### Deprecated mutations

* collectionPublish: deprecated
* collectionUnpublish: deprecated
* deliveryShippingOriginAssign: deprecated
* eventBridgeWebhookSubscriptionCreate: deprecated
* eventBridgeWebhookSubscriptionUpdate: deprecated
* fulfillmentCreateV2: deprecated
* fulfillmentTrackingInfoUpdateV2: deprecated
* orderEditRemoveLineItemDiscount: deprecated
* productCreateMedia: deprecated
* productDeleteMedia: deprecated
* productPublish: deprecated
* productUnpublish: deprecated
* productUpdateMedia: deprecated
* stagedUploadTargetGenerate: deprecated
* stagedUploadTargetsGenerate: deprecated

***

## UserError Mutations

### Mutated by

* [app​Purchase​One​Time​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appPurchaseOneTimeCreate)
* [app​Subscription​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCancel)
* [app​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate)
* [app​Subscription​Line​Item​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionLineItemUpdate)
* [app​Usage​Record​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appUsageRecordCreate)
* [bulk​Operation​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationCancel)
* [collection​Add​Products](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionAddProducts)
* [collection​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionCreate)
* [collection​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionDelete)
* [collection​Remove​Products](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionRemoveProducts)
* [collection​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionUpdate)
* [customer​Add​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddTaxExemptions)
* [customer​Address​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddressCreate)
* [customer​Address​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddressDelete)
* [customer​Address​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerAddressUpdate)
* [customer​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerCreate)
* [customer​Delete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerDelete)
* [customer​Generate​Account​Activation​Url](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerGenerateAccountActivationUrl)
* [customer​Payment​Method​Credit​Card​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerPaymentMethodCreditCardCreate)
* [customer​Payment​Method​Credit​Card​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerPaymentMethodCreditCardUpdate)
* [customer​Payment​Method​Revoke](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerPaymentMethodRevoke)
* [customer​Payment​Method​Send​Update​Email](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerPaymentMethodSendUpdateEmail)
* [customer​Remove​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerRemoveTaxExemptions)
* [customer​Replace​Tax​Exemptions](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerReplaceTaxExemptions)
* [customer​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdate)
* [customer​Update​Default​Address](https://shopify.dev/docs/api/admin-graphql/latest/mutations/customerUpdateDefaultAddress)
* [delivery​Profile​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/deliveryProfileCreate)
* [delivery​Profile​Remove](https://shopify.dev/docs/api/admin-graphql/latest/mutations/deliveryProfileRemove)
* [delivery​Profile​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/deliveryProfileUpdate)
* [delivery​Promise​Participants​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/deliveryPromiseParticipantsUpdate)

***

## Interfaces

* DisplayableError

***

## UserError Implements

### Implements

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