---
title: CartUserError - Storefront API
description: Represents an error that happens during execution of a cart mutation.
api_version: 2025-10
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/CartUserError
  md: https://shopify.dev/docs/api/storefront/latest/objects/CartUserError.md
---

# Cart​User​Error

object

Represents an error that happens during execution of a cart mutation.

## Fields

* code

  [Cart​Error​Code](https://shopify.dev/docs/api/storefront/latest/enums/CartErrorCode)

  The error code.

* field

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

  The path to the input field that caused the error.

* message

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

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [cart​Attributes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartAttributesUpdate)

  mutation

  Updates the attributes on a cart.

* [cart​Buyer​Identity​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartBuyerIdentityUpdate)

  mutation

  Updates customer information associated with a cart. Buyer identity is used to determine [international pricing](https://shopify.dev/custom-storefronts/internationalization/international-pricing) and should match the customer's shipping address.

* [cart​Create](https://shopify.dev/docs/api/storefront/latest/mutations/cartCreate)

  mutation

  Creates a new cart.

* [cart​Delivery​Addresses​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesAdd)

  mutation

  Adds delivery addresses to the cart.

* [cart​Delivery​Addresses​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesRemove)

  mutation

  Removes delivery addresses from the cart.

* [cart​Delivery​Addresses​Replace](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace)

  mutation

  Replaces delivery addresses on the cart.

* [cart​Delivery​Addresses​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesUpdate)

  mutation

  Updates one or more delivery addresses on a cart.

* [cart​Discount​Codes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartDiscountCodesUpdate)

  mutation

  Updates the discount codes applied to the cart.

* [cart​Gift​Card​Codes​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesAdd)

  mutation

  Adds gift card codes to the cart without replacing existing ones.

* [cart​Gift​Card​Codes​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesRemove)

  mutation

  Removes the gift card codes applied to the cart.

* [cart​Gift​Card​Codes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesUpdate)

  mutation

  Updates the gift card codes applied to the cart.

* [cart​Lines​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesAdd)

  mutation

  Adds a merchandise line to the cart.

* [cart​Lines​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesRemove)

  mutation

  Removes one or more merchandise lines from the cart.

* [cart​Lines​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesUpdate)

  mutation

  Updates one or more merchandise lines on a cart.

* [cart​Note​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartNoteUpdate)

  mutation

  Updates the note on the cart.

* [cart​Selected​Delivery​Options​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartSelectedDeliveryOptionsUpdate)

  mutation

  Update the selected delivery options for a delivery group.

***

## <\~> CartUserError Mutations

### Mutated by

* <\~>[cart​Attributes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartAttributesUpdate)
* <\~>[cart​Buyer​Identity​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartBuyerIdentityUpdate)
* <\~>[cart​Create](https://shopify.dev/docs/api/storefront/latest/mutations/cartCreate)
* <\~>[cart​Delivery​Addresses​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesAdd)
* <\~>[cart​Delivery​Addresses​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesRemove)
* <\~>[cart​Delivery​Addresses​Replace](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesReplace)
* <\~>[cart​Delivery​Addresses​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesUpdate)
* <\~>[cart​Discount​Codes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartDiscountCodesUpdate)
* <\~>[cart​Gift​Card​Codes​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesAdd)
* <\~>[cart​Gift​Card​Codes​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesRemove)
* <\~>[cart​Gift​Card​Codes​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesUpdate)
* <\~>[cart​Lines​Add](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesAdd)
* <\~>[cart​Lines​Remove](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesRemove)
* <\~>[cart​Lines​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartLinesUpdate)
* <\~>[cart​Note​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartNoteUpdate)
* <\~>[cart​Selected​Delivery​Options​Update](https://shopify.dev/docs/api/storefront/latest/mutations/cartSelectedDeliveryOptionsUpdate)

***

## Interfaces

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

  interface

***

## ||-CartUserError Implements

### Implements

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