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
| Parameter | Type | Description |
|---|---|---|
items | CartItem[] | Array of items to add |
CartItem Object:
| Property | Type | Required | Description |
|---|---|---|---|
variant_id | number | Yes | Product variant ID |
quantity | number | No | Quantity to add (default: 1) |
subscribe | boolean | No | Enable subscription |
Shorthand Form
| Parameter | Type | Description |
|---|---|---|
variantId | number | Product variant ID |
options | object | Options 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:
<!-- Basic add to cart --> <button data-fluid-add-to-cart="123456">Add to Cart</button> <!-- With quantity --> <button data-fluid-add-to-cart="123456" data-fluid-quantity="2"> Add 2 to Cart </button> <!-- With subscription --> <button data-fluid-add-to-cart="123456" data-fluid-subscribe="true"> Subscribe </button> <!-- With specific subscription plan --> <button data-fluid-add-to-cart="123456" data-fluid-subscription-plan-id="99" > Subscribe with Plan </button> <!-- Add multiple items --> <button data-fluid-add-to-cart="123456,789012">Add Both</button> <!-- Control cart opening after add --> <button data-fluid-add-to-cart="123456" data-fluid-open-cart-after-add="false" > Add Silently </button>
Related
- updateCartItems — Update item quantities
- removeCartItemById — Remove items