Cart Promo Message

The "Cart Promo Message" app block shows shoppers how close they are to their next reward, right above the items on your cart page. For example:
- "Add 2 more for 20% off"
- "10% off applied. Add $23.00 more for 15% off"
- "You unlocked 20% off"
The message is built from the discounts you created in our app, so there's nothing to type in for each discount. It updates as soon as the shopper changes their cart.
The same message can also show in your cart drawer, and a product page version tells shoppers what they get by adding that product (see "In the cart drawer" and "On product pages" below). The cart drawer message, the product page message and free gift badges are part of the Storefront Widgets add-on, which you can turn on from the Billing page in the app.
Use Cases
- Showing a progress bar toward the next volume or tiered discount on the cart page
- Telling shoppers how much more to spend to unlock a discount
- Telling shoppers how many more items they need for a quantity break
- Showing the same message in the cart drawer
- Telling shoppers on the product page what they get by adding the product, including a free gift
- Labeling products that come with a free gift on collection and search pages
Which discounts it shows
The message works with automatic product discounts where the missing piece is the cart's item count or subtotal:
- Volume/tiered/quantity breaks discounts, based on quantity or on price.
- Product discounts with a minimum purchase requirement (a minimum subtotal or a minimum number of items).
If several discounts apply, the message shows the reward the shopper is closest to.
Deals with a set price, like "2 for $25", show a message when you set them up as a quantity tier with a fixed price, for example 2 or more at a fixed price of $12.50 each. The message then uses the tier's message: "Add 1 more for 2 for $25". The same deal built as a "Buy X" rule doesn't show a message.
The message only promises a reward the shopper will actually get. If something else would still stop the discount from applying (for example a customer tag, or a product that isn't in the cart), the message stays hidden instead of showing a wrong promise. It also stays hidden when none of your discounts fit the list above. Order discounts and shipping discounts don't show a message yet. For free gifts, see "On product pages" below.
Checklist
- Create at least 1 automatic product discount with volume tiers or a minimum purchase requirement.
- Make sure the Discounts Embed is turned on in your theme. Follow the Discounts on Product Pages tutorial if you haven't set it up yet.
- Add the "Cart Promo Message" block to your cart page. If you use Automatic DOPP Setup, the theme ZIP adds it for you (unless you untick "Add the Cart Promo Message to the cart page"). To add it by hand:
- In the Theme Editor, open the Cart page template.
- Click "Add section", open the "Apps" tab, and choose "Cart Promo Message".
- Save.
- Preview your cart with 1 eligible item in it, then change the quantity to see the message update.
It doesn't matter exactly where you put the block on the cart page. On your storefront, the message always moves to just above the cart items.
In the cart drawer
To show the same message at the top of your theme's cart drawer (the cart that slides out when a shopper adds an item), turn on the "Cart Drawer Promo Message" app embed:
- In the Theme Editor, click "App embeds" (the puzzle icon).
- Turn on "Cart Drawer Promo Message", then save.
The message moves to just above the items in the drawer and updates as the shopper changes their cart. It stays hidden while the drawer is empty. The embed has the same settings as the cart page block (see "Customization options" below), set separately, so you can for example use text only in the drawer and a progress bar on the cart page.
On product pages
The "Product Promo Message" app block shows shoppers what they get by adding this product. For example:
- "Add 1 more for 10% off"
- "10% off with this item. Add 3 more for 20% off"
- "Comes with a free Tote Bag"
It counts what's already in the shopper's cart plus the selected variant and quantity, and it updates when the shopper changes either. The free gift line shows when this product on its own qualifies for a 100% off Auto Add to Cart gift.
To add it, open the Product page template in the Theme Editor, add the "Product Promo Message" app block (from "Add block" in the product information section, or "Add section", then the "Apps" tab), and save. Its style, color, corner radius and wording settings work like the cart page block's (see "Customization options" below), plus:
- Show spend and item count goals: turn this off to show only the free gift line.
- Show free gifts: turn this off to hide the free gift line.
- Free gift: the free gift wording. Use
[gift]for the gift's name.
"Free gift" badge on product cards
To label products that come with a free gift on collection pages, search results and featured product sections, type a badge text (for example "Free gift") in the "Free gift badge" setting of the Collection Page Discount, Search Page Discount or Featured Products Discount block. Leave it blank for no badge. If a product also has a price discount, the discount badge shows instead.
Customization options

You can change the following in the block's settings in the Theme Editor:
- Style: a progress bar with a marker for each reward, or text only.
- Show before the shopper qualifies: turn this off to only show the message once a reward applies.
- Show when every reward is unlocked: turn this off to hide the message once the shopper has the best reward.
- Progress bar color: leave it blank to use your theme's text color.
- Corner radius: from 0 to 12px.
- Wording: each message has its own text setting (Item count goal, Spend goal, Reward already applied, Every reward unlocked). Leave a setting blank to use our default wording. You can use these placeholders:
[items_needed]: how many more items the shopper needs.[amount_needed]: how much more the shopper needs to spend, in their currency.[next_reward]: the next reward, for example "20% off".[current_reward]: the reward the cart already gets.
The message uses your theme's font and text color, so it matches your store without any setup.
Reward names
By default, rewards are described by their value, for example "20% off" or "$5.00 off". To use your own names, give the tier a title in the discount editor. For example, a tier titled "Free tote bag" shows as "Add $23.00 more for Free tote bag".
Custom CSS
For changes the settings don't cover, add CSS to your theme. In most themes it goes in Theme settings, then "Custom CSS". If your theme doesn't have that setting, add it to your theme's main stylesheet with "Edit code".
Start each selector with body so it wins over our default styles. The message uses these classes:
.regios-cart-promo: the whole message box. It also has.regios-cart-promo--unlockedonce every reward is unlocked..regios-cart-promo__text: the message text..regios-cart-promo__icon: the gift or check icon..regios-cart-promo__bar: the progress bar track, and.regios-cart-promo__bar-fill: the filled part..regios-cart-promo__marker: the dots for each reward on the bar.
For example, this makes the text bigger and bold, gives the box a light orange background and makes the bar thicker:
body .regios-cart-promo__text { font-size: 18px; font-weight: 600; }
body .regios-cart-promo { background: #fff4e5; }
body .regios-cart-promo__bar { height: 10px; }
Hide or remove the message
- Remove it everywhere: in the Theme Editor, open the Cart page template, click the "Cart Promo Message" block and remove it (or click the eye icon to hide it). Then save. This also works if the theme ZIP from Automatic DOPP Setup added the block. It doesn't change your discounts.
- Hide it before the shopper qualifies, or after every reward is unlocked: turn off "Show before the shopper qualifies" or "Show when every reward is unlocked" in the block's settings.
- Hide only the progress bar: set "Style" to "Text only".
- Turn off the cart drawer message: in the Theme Editor, click "App embeds" (the puzzle icon), turn off "Cart Drawer Promo Message", and save.
- Remove the product page message: in the Theme Editor, open the Product page template, click the "Product Promo Message" block and remove it (or click the eye icon to hide it), then save. To keep the message but drop the free gift line, turn off "Show free gifts" in its settings.
- Remove the free gift badge: clear the "Free gift badge" setting in the Collection Page Discount, Search Page Discount or Featured Products Discount block.
- Hide it on mobile: add this to your theme's custom CSS (see above):
@media (max-width: 749px) { body .regios-cart-promo { display: none; } }
Languages
The default wording is in English. For other languages, type your wording into the block's text settings, then translate those settings with Shopify's Translate & Adapt app.
Compatibility
- The "Cart Promo Message" block works on the cart page. For cart drawers, use the "Cart Drawer Promo Message" app embed (see above). Pop-up carts that aren't a drawer may not show it.
- It requires an Online Store 2.0 theme. It will not work with legacy 1.0 themes.
Your Feedback Matters
Your review helps keep this small business running. Please leave one on the Shopify App Store.
Updated on: 03/11/2026
Thank you!