---
title: Cart - Storefront API
description: |
  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](https://shopify.dev/custom-storefronts/internationalization/international-pricing)
  during a customer's session.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/cart
  md: https://shopify.dev/docs/api/storefront/latest/objects/cart.md
---

# 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](https://shopify.dev/custom-storefronts/internationalization/international-pricing) during a customer's session.

## Fields

* appliedGiftCards
* attribute
* attributes
* buyerIdentity
* checkoutUrl
* cost
* createdAt
* delivery
* deliveryGroups
* discountAllocations
* discountCodes
* id
* lines
* metafield
* metafields
* note
* totalQuantity
* updatedAt
* estimatedCost: deprecated

***

## Map

### Possible type in

* [Metafield​Parent​Resource](https://shopify.dev/docs/api/storefront/latest/unions/MetafieldParentResource)

***

## Queries

* cart

***

## Cart Queries

### Queried by

* [cart](https://shopify.dev/docs/api/storefront/latest/queries/cart)

***

## Mutations

* cartAttributesUpdate
* cartBuyerIdentityUpdate
* cartCreate
* cartDeliveryAddressesAdd
* cartDeliveryAddressesRemove
* cartDeliveryAddressesReplace
* cartDeliveryAddressesUpdate
* cartDiscountCodesUpdate
* cartGiftCardCodesAdd
* cartGiftCardCodesRemove
* cartGiftCardCodesUpdate
* cartLinesAdd
* cartLinesRemove
* cartLinesUpdate
* cartNoteUpdate
* cartSelectedDeliveryOptionsUpdate

***

## Cart 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

* HasMetafields
* Node

***

## Cart Implements

### Implements

* [Has​Metafields](https://shopify.dev/docs/api/storefront/latest/interfaces/HasMetafields)
* [Node](https://shopify.dev/docs/api/storefront/latest/interfaces/Node)