Advanced components
Quantity On Cart

The Quantity on Cart app allows you to display a message to your customers informing how many units of a product they have added to the cart. This message can be displayed in a Shelf or in a product page.

{"base64":"  ","img":{"width":1874,"height":856,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":4638002,"url":""}}

️ The Quantity On Cart app does not work with promotions scenarios such as Buy Together and Buy One Get One.


  1. Open the terminal and use the VTEX IO CLI to log into the desired VTEX account.
  2. Run the following command to install the Quantity On Cart app:
vtex install vtexarg.quantity-on-cart
  1. Open your store’s Store Theme app directory in your code editor.
  2. Open your app's manifest.json file and add the Quantity On Cart app under the peerDependencies field.
"peerDependencies": { "vtexarg.quantity-on-cart": "2.x" }
  1. Add the quantity-on-cart block to other theme block using a product context since the quantity-on-cart block handles product data, such as the store.productor the product-summary.shelf. For the example below, we have added to the product-summary.shelf:
{ "product-summary.shelf": { "children": [ + "quantity-on-cart" ] }, ...

After step 5, no further configuration is needed, and the app is ready to use in your store.

The displayed message in the Quantity On Cart app is available in three languages: English (EN), Spanish (ES), and Portuguese (PT), and follows the pattern below, which cannot be changed: EN - You have x units in your shopping cart. | ES - Tienes x unidades en el carrito. | PT - Você tem x unidades no carrinho.


To apply CSS customizations in this and other blocks, follow the instructions given in the recipe on Using CSS Handles for store customization.

CSS Handles
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Suggest edits (Github)
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page