Skip to main content
shoppy.cart.add(variantId, quantity)
shoppy.cart.add(lines)
Adds one or more product variants to the cart.

​
Parameters

​
Single item

ParamTypeRequiredDescription
variantIdstringYesProduct variant GID
quantitynumberNoQuantity to add (default: 1)

​
Multiple items

ParamTypeRequiredDescription
linesCartLineInput[]YesArray of line items

​
Returns

Promise<ShopifyCart>

​
Examples

​
Add single item

await shoppy.cart.add('gid://shopify/ProductVariant/123')

​
Add with quantity

await shoppy.cart.add('gid://shopify/ProductVariant/123', 3)

​
Add multiple items

await shoppy.cart.add([
    { merchandiseId: 'gid://shopify/ProductVariant/123', quantity: 2 },
    { merchandiseId: 'gid://shopify/ProductVariant/456', quantity: 1 }
])

​
With product data

// After fetching a product
const product = await shoppy.products.get('awesome-tshirt')
const variant = product.variants[0]

await shoppy.cart.add(variant.id, 1)

​
Add to cart button

document.querySelector('.add-to-cart').addEventListener('click', async () => {
    const variantId = this.dataset.variantId
    const quantity = parseInt(this.dataset.quantity) || 1

    await shoppy.cart.add(variantId, quantity)
})