Choose a version:

Cart

object

A cart represents the merchandise that a buyer intends to purchase, and the estimated cost associated with the cart. Learn how to interact with a cart during a customer's session.

Anchor to FieldsFields

Anchor to appliedGiftCardsappliedGiftCards •[AppliedGiftCard!]! non-null: The gift cards that have been applied to the cart.
Anchor to attributeattribute •Attribute: An attribute associated with the cart.
Anchor to attributesattributes •[Attribute!]! non-null: The attributes associated with the cart. Attributes are represented as key-value pairs.
Anchor to buyerIdentitybuyerIdentity •CartBuyerIdentity! non-null: Information about the buyer that's interacting with the cart.
Anchor to checkoutUrlcheckoutUrl •URL! non-null: The URL of the checkout for the cart.
Anchor to costcost •CartCost! non-null: The estimated costs that the buyer will pay at checkout. The costs are subject to change and changes will be reflected at checkout. The cost field uses the buyerIdentity field to determine international pricing.
Anchor to createdAtcreatedAt •DateTime! non-null: The date and time when the cart was created.
Anchor to deliverydelivery •CartDelivery! non-null: The delivery properties of the cart.
Anchor to deliveryGroupsdeliveryGroups •CartDeliveryGroupConnection! non-null: The delivery groups available for the cart, based on the buyer identity default delivery address preference or the default address of the logged-in customer.
Anchor to discountAllocationsdiscountAllocations •[CartDiscountAllocation!]! non-null: The discounts that have been applied to the entire cart.
Anchor to discountCodesdiscountCodes •[CartDiscountCode!]! non-null: The case-insensitive discount codes that the customer added at checkout.
Anchor to idid •ID! non-null: A globally-unique ID.
Anchor to lineslines •BaseCartLineConnection! non-null: A list of lines containing information about the items the customer intends to purchase.
Anchor to metafieldmetafield •Metafield: A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.
Anchor to metafieldsmetafields •[Metafield]! non-null: A list of custom fields that a merchant associates with a Shopify resource.
Anchor to notenote •String: A note that's associated with the cart. For example, the note can be a personalized message to the buyer.
Anchor to totalQuantitytotalQuantity •Int! non-null: The total number of items in the cart.
Anchor to updatedAtupdatedAt •DateTime! non-null: The date and time when the cart was updated.
Anchor to estimatedCostestimatedCost •CartEstimatedCost! non-nullDeprecated

Was this section helpful?

Anchor to QueriesQueries

Anchor to cart cart •query: Retrieve a cart by its ID. For more information, refer to Manage a cart with the Storefront API.

Was this section helpful?

Anchor to MutationsMutations

Anchor to cartAttributesUpdate cartAttributesUpdate •mutation: Updates the attributes on a cart.
Anchor to cartBuyerIdentityUpdate cartBuyerIdentityUpdate •mutation: Updates customer information associated with a cart. Buyer identity is used to determine international pricing and should match the customer's shipping address.
Anchor to cartCreate cartCreate •mutation: Creates a new cart.
Anchor to cartDeliveryAddressesAdd cartDeliveryAddressesAdd •mutation: Adds delivery addresses to the cart.
Anchor to cartDeliveryAddressesRemove cartDeliveryAddressesRemove •mutation: Removes delivery addresses from the cart.
Anchor to cartDeliveryAddressesUpdate cartDeliveryAddressesUpdate •mutation: Updates one or more delivery addresses on a cart.
Anchor to cartDiscountCodesUpdate cartDiscountCodesUpdate •mutation: Updates the discount codes applied to the cart.
Anchor to cartGiftCardCodesRemove cartGiftCardCodesRemove •mutation: Removes the gift card codes applied to the cart.
Anchor to cartGiftCardCodesUpdate cartGiftCardCodesUpdate •mutation: Updates the gift card codes applied to the cart.
Anchor to cartLinesAdd cartLinesAdd •mutation: Adds a merchandise line to the cart.
Anchor to cartLinesRemove cartLinesRemove •mutation: Removes one or more merchandise lines from the cart.
Anchor to cartLinesUpdate cartLinesUpdate •mutation: Updates one or more merchandise lines on a cart.
Anchor to cartNoteUpdate cartNoteUpdate •mutation: Updates the note on the cart.
Anchor to cartSelectedDeliveryOptionsUpdate cartSelectedDeliveryOptionsUpdate •mutation: Update the selected delivery options for a delivery group.

Was this section helpful?

Anchor to InterfacesInterfaces

Anchor to HasMetafields HasMetafields •interface
Anchor to Node Node •interface

Was this section helpful?