TURBO for Developers

Home > widget-integration > CartController > addToCart

CartController.addToCart() method

Add product to cart with optional cart modal display

Signature:

addToCart(params: unknown, button?: HTMLElement | null, shouldOpenCart?: boolean, callback?: () => void): Promise<void>;

Parameters

Parameter	Type	Description
params	unknown	Product parameters (variant ID, quantity, properties, etc.)
button	HTMLElement \| null	(Optional) Optional button element to show loading states
shouldOpenCart	boolean	(Optional) Whether to open cart modal after adding (default: true)
callback	() => void	(Optional) Optional callback to execute after operation

Returns:

Promise<void>

Example

// Add to cart and show modal
await cartController.addToCart({ id: '12345', quantity: 2 });

// Add to cart without showing modal
await cartController.addToCart({ id: '12345' }, null, false);

// Add with button loading state
const button = document.querySelector('.add-to-cart-btn');
await cartController.addToCart({ id: '12345' }, button, true, () => {
  console.log('Added to cart!');
});