Articles in this category

Altering cart widget functions by embedding Subbly Javascript

Binu Francis Updated by Binu Francis

Trying to customize the cart widget to behave a certain way by default? Subbly's cart widget is incredibly powerful yet flexible tool, and allows you to embed code snippets within your websites' pages to make it work per your requirements!


You can add the Javascript code snippets shared below to your website pages' head section, before the </head> tag. If you're using the Subbly website builder, you can add the code within Dashboard > Site settings > Code Injection, and paste the code snippet within the Before </head> tag section.

Adding snippets in code injection section on Subbly website applies it to all pages on the site

On 3rd party websites, you can use similar Code Injection or Code embed functions that allow you to add custom Javascript code to your pages.

Now that we know where the code snippets are added, let's proceed to explore all the different functions that can be performed on the cart widget, and code snippets associated with those functions.

How to replace cart icon or buttons on your website

If you wish to replace the cart icon or cart button on your website with another one, you can do so by assigning .subbly-cart and .subbly-cart-product-count parameters to your cart button elements on the page, like so -

<a href="#" data-subbly-cart-toggle class="subbly-cart">
<span class="subbly-cart-product-count"></span>
<img src="your-icon-image-url" alt="Cart Icon">

Replace your-icon-image-url with the URL of the image or icon you want to be displayed as the cart on your website.

By adding this code to your webpage, you will be able to display a button that toggles the Subbly cart widget. The .subbly-cart class is used to target the button element, and the .subbly-cart-product-count class is used for the item count in the cart widget.

How to add Subbly's floating cart button

If you don't have a cart button on your website(or just simply wish to switch over to Subbly's floating button) you can enable it by setting the cartButton: true within the cart widget installation code.

Once added, the floating cart button shows up on the top right side of your website screen, and stays in the same location (i.e. floats) even as you're scrolling, so it always stays accessible.

The floating cart button is also enabled by default, so if you want to disable or remove it, you can set the cartButton: false in case you already have a cart button set up and want to retain that instead.

Setting up Subscribe/Buy buttons without checkout URLs

You might have been linking the Subscribe and Buy buttons on your site directly with your product's checkout URL - and this triggers the checkout widget, since interceptProductLinks: true is set in the cart widget code. This effectively makes it so Subbly intercepts the product checkout URLs from going to checkout pages directly, and instead adds the product to the cart and opens up the cart widget.

There's another way to add products to cart and open the cart widget - it's by adding the following code to your Subscribe/Buy buttons -

<a href="#' data-subbly-product=(PRODUCT_ID)></a>
Replace (PRODUCT_ID) with your product's ID on Subbly Admin so when customers click on the Subscribe button, they add the specified product set up within your Subbly account to the cart.

Pre-defining product quantity and addon choices

If you wish to have a certain quantity of one-time products added to the cart, or have the specified one-time products and quantity added onto a subscription that's also in the customers' cart, that can be done by passing on the following parameters in the button code -

data-subbly-product : to specify the product ID you want to be added

data-subbly-quantity : to specify the quantity of the product specified in data-subbly-product

data-subbly-addon : to specify if the product specified in data-subbly-product should be attached as an addon

data-subbly-duration : to specify whether addon should be added as a one-time addition to the subscription, or forever/recurring basis. Values can be once or forever.

Resulting code can look like so -

<a href="#' data-subbly-product=27456 data-subbly-addon data-subbly-duration=forever>

Pre-apply a coupon to the cart for all products on the page

If you have a separate landing page or shop page for a specific promotion, and wish to have a coupon automatically applied when customers click on the Subscribe or Buy buttons on that page, you can add the following code to the Head section of that page -

window.addEventListener('subbly-cart-initialized', () => {
As mentined earlier in the article, adding code to Subbly's Code injection section adds it to all pages on the website. So if you're adding this code to your Subbly website, note that it'll apply to all pages, and hence pre-apply the coupon for customers who click Subscribe or Buy across any page on the site.

Setting cart widget language

If you want to set the cart to default to a certain translation language you've added in your storefront translation settings, you can do so by adding the language short code in the code snippet below and adding it to the head section of your page -

window.addEventListener('subbly-cart-initialized', () => {
Replace the language short code fr in the snippet above with a language short code you've set up in your account(example - en, es, de, etc.)

You can also pass on the language shortcode as a parameter in your checkout URL to load the cart widget in that language, for example,

Similarly, you can also add the language parameter within your page's html tag to make it load the checkout widget in the required language, for example, <html lang="fr">

Setting cart currency

You can set the currency used on the cart widget by adding the following code snippet to the head section of the page -

window.addEventListener('subbly-cart-initialized', () => {
You can replace USD in the code snippet above with the currency of your choice(make sure you've set up the currency in currency settings)

Uploading a custom font

You have a set of pre-loaded fonts on Subbly you can choose to add to your cart widget under cart settings, but if you need to add a custom font - you can add it by adding it to your style sheet(in the head section) like in any of the ways shown below -

#subbly-cart-widget {
--font-primary: "YourFontName" !important;


@font-face {
font-family: "YourFontName";
src: url("path/to/your/font.woff") format("woff");

.subbly-widget {
font-family: "YourFontName";
By adding this code to your webpage and replacing "YourFontName" with the name of your font and "path/to/your/font.woff" with the actual path to your font file, your cart widget will use your custom font.

If you're facing any problems while setting up these scripts, please feel free to contact support for assistance.

Did you find this resource helpful?
Return to top
Ready to get started
with Subbly?
Try for free