Last updated

addCartItems()

Adds one or more items to the cart.

Signature

// Add multiple items
await window.FairShareSDK.addCartItems(items);

// Add single item (shorthand)
await window.FairShareSDK.addCartItems(variantId, options);

Parameters

Array Form

ParameterTypeDescription
itemsCartItem[]Array of items to add

CartItem Object:

PropertyTypeRequiredDescription
variant_idnumberYesProduct variant ID
quantitynumberNoQuantity to add (default: 1)
subscribebooleanNoEnable subscription

Shorthand Form

ParameterTypeDescription
variantIdnumberProduct variant ID
optionsobjectOptions with quantity and subscribe

Examples

Add Multiple Items

await window.FairShareSDK.addCartItems([
  { variant_id: 123, quantity: 2, subscribe: true },
  { variant_id: 456, quantity: 1 },
]);

Add Single Item

await window.FairShareSDK.addCartItems(123, { 
  quantity: 2, 
  subscribe: true 
});

Simple Add

await window.FairShareSDK.addCartItems(123);

HTML Alternative

Use data attributes without JavaScript:

<button data-fluid-add-to-cart="123456">Add to Cart</button>

<button 
  data-fluid-add-to-cart="123456" 
  data-fluid-quantity="2"
  data-fluid-subscribe="true"
>
  Add 2 with Subscription
</button>