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.
Fields and connections
The gift cards that have been applied to the cart.
An attribute associated with the cart.
The attributes associated with the cart. Attributes are represented as key-value pairs.
Information about the buyer that's interacting with the cart.
The URL of the checkout for the cart.
The estimated costs that the buyer will pay at checkout. The costs are subject to change and changes will be reflected at checkout. The
costfield uses thefield to determine international pricing.The date and time when the cart was created.
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.
The discounts that have been applied to the entire cart.
The case-insensitive discount codes that the customer added at checkout.
A globally-unique ID.
A list of lines containing information about the items the customer intends to purchase.
Returns a metafield found by namespace and key.
The metafields associated with the resource matching the supplied list of namespaces and keys.
A note that's associated with the cart. For example, the note can be a personalized message to the buyer.
The total number of items in the cart.
The date and time when the cart was updated.
- Anchor to cartquery
Retrieve a cart by its ID. For more information, refer to Manage a cart with the Storefront API.
Mutations
Updates the attributes on a cart.
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 cartCreatemutation
Creates a new cart.
Updates the discount codes applied to the cart.
Updates the gift card codes applied to the cart.
- Anchor to cartLinesAddmutation
Adds a merchandise line to the cart.
- Anchor to cartLinesRemovemutation
Removes one or more merchandise lines from the cart.
- Anchor to cartLinesUpdatemutation
Updates one or more merchandise lines on a cart.
- Anchor to cartNoteUpdatemutation
Updates the note on the cart.
Update the selected delivery options for a delivery group.