Use this article to change how one product behaves inside the Smart Cart without changing any cart setting. You do it by adding a Rebuy product tag to the product in your Shopify admin, under Products, the product, then the Tags field.
Smart Cart tags are plain Shopify product tags that Rebuy watches for. When a product carrying one lands in the cart, the Smart Cart changes that line item: it can hide the line, hide or freeze its quantity control, remove its product link, hide a bundle's contents list, or leave the line out of the Tiered Progress Bar's progress. Tags work on the latest Smart Cart version and on Legacy Smart Cart, and no Shopify plan is required.
Tags change how a line item is displayed and counted, and they never change what Shopify charges. A tagged product is still in the cart, still goes to checkout, and is still paid for.
What each Smart Cart product tag changes
The table below lists the Smart Cart product tags covered in this article, what each one changes on a cart line item, and what each one deliberately leaves alone. A tag that is not in this table is not one this article supports.
Tag | What it changes on the line item | What it leaves alone |
| Removes the line from the list of cart items and subtracts its quantity from the Smart Cart's item count | The cart subtotal, which still includes the line's value |
| Hides the quantity control on the line completely | The quantity itself, which stays where it was |
| Leaves the quantity control visible but makes it impossible to click | Whether the line is displayed at all |
| Removes the link from the line's image and title, so the product page cannot be opened from the cart | Whether the line is displayed at all |
| Hides the expandable bundle contents list on a bundle line item | The bundle, which is still in the cart and still charged |
| Removes the line from Tiered Progress Bar progress, whichever unlock condition the bar uses, Price or Item Quantity | The cart subtotal and what Shopify charges, both of which still include the line's value |
Add or remove a Smart Cart tag on a product
Adding a Smart Cart tag is done in your Shopify admin, on the product itself.
In your Shopify admin, open Products and select the product.
In the Tags field, type the tag exactly as it appears in the table above. Shopify's own steps are in Shopify's guide to using tags.
Click Save.
Clear your Rebuy product cache, then reload your storefront. The steps are in Sync Product Data, Store Data, and Clear Cache.
Removing a tag is the same sequence with the tag deleted from the Tags field, and step 4 matters just as much on the way out.
How Rebuy matches a Smart Cart tag
Rebuy reads Smart Cart tags from the product, not from a variant and not from a collection, so a tag applies to every variant of the product it is on and there is no way to tag only some variants.
Matching is exact and case sensitive. Rebuy splits the product's tag string on commas and trims the spaces, so Smart-Cart-Hidden and smart cart hidden match nothing. smart-cart-disable-click and smart-cart-disable-quantity are matched a little more loosely, anywhere in the tag string, so a longer tag that contains either string inside it triggers the same behavior.
Rebuy caches the product data behind these tags in the shopper's browser for one hour, so a tag added or removed in Shopify is not instant on the storefront. Clearing the product cache and reloading is what makes the change take effect immediately.
Hide a line item from the cart with smart-cart-hidden
smart-cart-hidden removes a product's line from the list of items in the Smart Cart, so a shopper does not see it in the cart at all. Its quantity is subtracted from the item count the Smart Cart reports, and its value stays in the cart subtotal, so the subtotal and the visible lines will not add up.
The product is still in the Shopify cart and still goes to checkout. Use this tag for lines a shopper should not manage, not to stop a product being purchased.
One case is left out of the count subtraction on purpose. A hidden line that the Tiered Progress Bar added as a gift still counts toward the item count, which keeps the Smart Cart's count matching Shopify's own.
Hide the quantity control with smart-cart-hide-qty
smart-cart-hide-qty hides the quantity control on a product's line item completely, so the line shows its title, image, and price with no way to change how many are in the cart. The quantity itself is untouched and stays at whatever the shopper already added.
Gift line items added by the Tiered Progress Bar already have their quantity control hidden without any tag, so this tag is not needed for them.
Show a quantity control that cannot be changed with smart-cart-disable-quantity
smart-cart-disable-quantity leaves the quantity control on the line item visible but makes it impossible to interact with, so a shopper can see the quantity and cannot change it. Use it instead of smart-cart-hide-qty when the number itself is worth showing.
This tag is matched anywhere in the product's tag string, so a longer tag containing smart-cart-disable-quantity inside it disables the control too.
Stop shoppers opening the product page with smart-cart-disable-click
smart-cart-disable-click removes the link from a line item's image and title, so a shopper cannot navigate from the cart to that product's page. The line still renders normally and everything else about it behaves as usual.
This tag is matched anywhere in the product's tag string, so a longer tag containing smart-cart-disable-click inside it removes the link too.
Hide a bundle's contents list with smart-cart-hide-bundle-options
smart-cart-hide-bundle-options hides the expandable contents list on a bundle line item, so the bundle shows as a single row with no control to open and see what is inside it. Rebuy checks the tag on the product with no condition on where the bundle came from, so it applies to any cart line that would otherwise render a contents list.
Rebuy previously recommended this tag for pre-built Shopify Bundles. Those bundles list their contents correctly now, so a pre-built Shopify Bundle still carrying the tag is hiding a list that would otherwise work, and the tag should come off it. The full picture is in Smart Cart: Show Shopify Bundle Contents in the Cart.
Keep a product out of Tiered Progress Bar progress with smart-cart-shipping-excluded
smart-cart-shipping-excluded removes a product's line from the progress the Tiered Progress Bar calculates, whichever unlock condition the bar uses, Price or Item Quantity. The line still renders in the cart, still counts toward the Smart Cart's item count, and its value stays in the cart subtotal. The bar itself is documented in Tiered Progress Bar and the Smart Cart.
The exclusion applies to the whole bar rather than to one tier, so a product cannot be excluded from a free shipping tier while still counting toward a free product tier on the same bar. The tag changes the progress the bar displays and never changes what Shopify charges, so on an Order Discount tier it does not stop the discount from applying, as described below.
smart-cart-shipping-excluded does not stop an Order Discount tier from applying
smart-cart-shipping-excluded does not stop an Order Discount tier from discounting an order. On a bar that has an Order Discount tier the tag still removes the tagged line from the progress the bar displays, and the discount itself still applies as soon as the cart reaches the threshold, whether or not the tagged product is what got it there.
The reason is that Rebuy applies an order discount through a Shopify Function, and that function is given the excluded variants from your bar's own settings rather than the product's tags. It therefore measures the cart Shopify actually holds, which can leave the bar showing less progress than the discount was calculated from.
Here is that mismatch in a real cart. The bar has one Order Discount tier, set to 50% off at an Unlock Price of $300.00. The cart holds an untagged product at $100.00 each with a quantity of 2, plus a product tagged smart-cart-shipping-excluded at $25.00 each with a quantity of 4, so the cart is worth $300.00. The bar leaves the tagged product's $100.00 out of what it measures, measures $200.00, and reports $100.00 still to go. The Shopify Function measures the full $300.00, finds the threshold met, and takes $150.00 off. The shopper sees the order discount already applied in the cart while the bar is still asking them for another $100.00.
To work around this and keep a product out of an order discount, use The Smart Cart's Tiered Progress Bar Search Products to Exclude setting under ADVANCED BAR SETTINGS on the bar instead of a tag. It appears when the bar has Use Shopify Functions (Recommended) turned on, and it is the setting the Shopify Function actually reads. Excluding a product there also removes it from the bar's progress, so the tag is not needed alongside it.
smart-cart-shipping-excluded does not change what Shopify charges for shipping
smart-cart-shipping-excluded does not change what Shopify charges for shipping. The tag holds a product back from the progress the bar displays toward a Free Shipping tier, and the free shipping a shopper actually receives comes from a shipping rate you set up in Shopify, which measures the whole cart and never reads Rebuy product tags.
A Free Shipping tier is a display. It tracks progress inside the cart and does not apply free shipping at checkout, which is covered in Tiered Progress Bar and the Smart Cart. The matching rate lives in your Shopify admin under Settings > Shipping and delivery, with its own minimum order amount.
A tagged product therefore creates the same mismatch on a Free Shipping tier that it creates on an Order Discount tier. Take a Shopify free shipping rate with a $300.00 minimum, a bar with a Free Shipping tier at an Unlock Price of $300.00, and a cart worth $300.00 of which $100.00 is a tagged product. The bar measures $200.00 and tells the shopper they are $100.00 away from free shipping. Shopify measures the full $300.00, meets its own minimum, and offers free shipping at checkout anyway.
The Smart Cart's Tiered Progress Bar Search Products to Exclude setting does not change this either. It moves the cart subtotal the bar measures, which is the amount at which free shipping is visually applied, and it does not reach the Shopify rate.
Because the Shopify rate is what decides, keeping a product from counting toward free shipping at checkout is a change to your Shopify shipping setup rather than to a Rebuy setting or a product tag. Shopify's own steps are in Setting up shipping rates.
Frequently asked questions
How do I stop a product from counting toward the Tiered Progress Bar threshold?
To stop a product counting toward the Tiered Progress Bar threshold, add the Shopify product tag smart-cart-shipping-excluded to it, then clear your Rebuy product cache. The product still shows as a line item in the cart and still counts toward the item count, and its value is removed from the subtotal the bar measures against. The exclusion applies to every tier on the bar at once, so a product cannot be excluded from one tier and counted by another.
Can I stop a product from receiving a Tiered Progress Bar order discount?
Yes, you can stop a product from receiving a Tiered Progress Bar order discount, using The Smart Cart's Tiered Progress Bar Search Products to Exclude setting under ADVANCED BAR SETTINGS on the bar rather than a product tag. That control appears when the bar has Use Shopify Functions (Recommended) turned on, and the Shopify Function that applies the discount reads it directly. Adding smart-cart-shipping-excluded to the product does not do this on its own, because the tag changes what the bar displays and the function that applies the discount never reads product tags. This is the usual question for gift cards and for products you never want discounted.
Can I exclude subscription products from counting toward the Tiered Progress Bar?
No, there is no tag or setting that excludes a cart line from the Tiered Progress Bar for being a subscription. Smart Cart tags are matched on the product, so tagging a product with smart-cart-shipping-excluded excludes it whether the shopper chose one-time or subscription, and there is no way to tag one delivery option without the other. Excluding subscriptions specifically needs custom JavaScript, which is outside standard support scope.