SubblyCart.js widget | Subbly Developers

SubblyCart.js adds a cart, a product configurator and a full checkout to any website, in your shop's colours and languages. One script tag is enough. The widget talks to the Storefront API through Subbly.js, and it keeps the cart ID and the customer's access token in cookies, so a cart survives a page load.

In this section

Install — embed the script and wait for the widget to be ready.
Configure — the keys of window.subblyConfig, and how to boot the widget by hand.
Keep it up to date — how the hosted widget updates, and how to self-host it.
Wire it into your page — buy links, your own cart button and counter, the container, and the content slots in the checkout.
Drive it from your code — call the methods and follow the events.
Style it — override the cart settings at runtime or from your own CSS.

Reference

The SubblyCart.js reference lists every method, event, configuration key and CSS variable.

Last modified on September 14, 2026

In this section

Install — embed the script and wait for the widget to be ready.
Configure — the keys of window.subblyConfig, and how to boot the widget by hand.
Keep it up to date — how the hosted widget updates, and how to self-host it.
Wire it into your page — buy links, your own cart button and counter, the container, and the content slots in the checkout.
Drive it from your code — call the methods and follow the events.
Style it — override the cart settings at runtime or from your own CSS.

Reference

The SubblyCart.js reference lists every method, event, configuration key and CSS variable.

Last modified on September 14, 2026