Documentation
Set up the bar, step by step.
Everything a merchant does in Yaco Progress Bar, in the order it happens: install, switch the app embed on, add tiers, choose how the gift is added, target, adapt to markets, save.
01
Getting started
- How to install Yaco Progress Bar on a Shopify store · Install the app, check the tiers it pre-fills from your offers, switch on the app embed and place the bar in your theme. The free plan starts on its own.
- Where to place the progress bar in a Shopify theme: cart drawer, cart page, product page · Click Place progress bar, then click the spot in your theme where the bar should go. App blocks, a code snippet and a free custom integration cover the rest.
- How to save and publish progress bar changes in Yaco · Changes stay a draft until you click Save. Saving updates the live bar and the Shopify discounts behind your tiers; daily backups let you roll back.
02
Tiers and bars
- How to add a tier to the Shopify progress bar · A tier is a reward the bar counts towards: free shipping message, free gift, percentage or amount off. Add it from Goals & Discounts, set its threshold, save.
- How to add a free shipping bar to your Shopify cart · The bar announces free shipping with a Text goal; the free shipping itself comes from your Shopify shipping rates or a shipping discount. Use the same threshold in both.
- How to offer a free gift with purchase above a cart amount on Shopify · Pick a product from your catalogue as the gift. Once the tier is reached, Yaco Progress Bar adds it to the cart and a Shopify automatic discount makes it free.
- How to set up a tiered discount (percentage or amount off) on Shopify · Choose Percentage off or Amount off. Yaco Progress Bar creates a Shopify automatic discount, applied at checkout once the cart reaches the tier, with no code to type.
- How to base a progress bar on cart amount, weight, quantity or order history · A bar sets what its tiers measure (cart amount, weight, number of items, or a customer’s lifetime spend or order count) and which products count towards it.
- How to show a tier only to some customers (VIP, B2B, campaign, dates) · Limit a tier by customer tags, segments, B2B or B2C, login state, traffic source, cart contents, country or dates. The automatic discount follows most of these rules.
- How to set a different free shipping threshold per Shopify market or country · Give a tier its own threshold in a Shopify market, country or region, or turn it off there. Customers see the threshold of their market, in their own currency.
03
Display
- How to customise the look of the cart progress bar without code · The Design page styles the bar without code: layout of the tiers, colours, markers, prices, images, spacing, mobile margins and custom CSS, saved as reusable designs.
- How to set the success message shown when all cart tiers are reached · The message line shows the next tier’s text, then a success message listing what the shopper unlocked once every tier is reached. You set it per design.
- How to let shoppers choose their free gift in a pop-up or with a button · When a gift tier offers several products or variants, a gift chooser pop-up lets the shopper pick. It opens on its own or from a “Choose a gift” button.
- How to show the progress bar and free gifts in Shopify checkout · On Shopify Plus, add the Progress bar block in the checkout editor to show your tiers and let shoppers pick or remove their gifts during checkout.
- How to translate the progress bar texts for each language and market · Each text of Yaco Progress Bar is translated from its own field, per language or per language and market. Texts left untranslated fall back to the main text.
04
Going further
- How to show product recommendations in the Shopify cart drawer and checkout · A recommendation block suggests products to add, based on rules you order. Place it in the cart, on the product page or at checkout, and sort it to reach the next tier.
- How to A/B test a free shipping bar on Shopify · Split your traffic between two placements of the bar, or against a group that sees no bar, and compare revenue per visitor and orders. A/B testing requires the Optimize plan.
- How to see the impact of the progress bar on average order value · The app home page shows average order value, orders, revenue and how often carts reach a tier, over up to 60 days, with a cart distribution chart that draws your tiers.
- How to subscribe, change plan or cancel Yaco Progress Bar · The free plan starts on its own, with unlimited tiers for 14 days, then 1. Pick a paid plan on the Subscription page and approve it in Shopify. Change or cancel any time.
- How to connect Claude or ChatGPT to your progress bar · Connect your AI assistant from Connect AI (Beta) in the app, then ask it to get you started: it reviews your setup, suggests a first tier and creates it once you agree.
- How to uninstall Yaco Progress Bar and what happens to your data · Uninstall from the app Settings to clean up first. Your setup is kept for 48 hours in case you reinstall, then all store data is permanently deleted and the subscription ends.
05
Troubleshooting
- Why isn't my progress bar showing on my Shopify store? · Most often the app embed is off or the bar is not placed in your theme. Check these first, then the tier targeting and your plan.
- Why is my tier discount not applied at checkout? · Usually a discount code or another automatic discount that does not combine, a product discount lowering the subtotal, or a tier set to Goal only.
- Why isn't the free gift added to the cart? · Check that the gift variant is active and in stock, then how the tier adds it: automatically, with a button, from a list, or not at all.
- Why is the free gift removed from the cart? · A removal rule on the tier, a discount code that does not combine with the gift, or a cart back under the threshold. Here is how to tell them apart.
- Why does the progress bar show the wrong cart amount? · The bar counts only what its settings include: excluded products, gift cards, discounts, currency and bundles all change the total. Check them in this order.
- Why does my cart drawer close or go blank after the gift is added? · Cart drawer glitches come from the way each theme refreshes its drawer, not from your tiers. What each symptom means, what you can adjust, and when to write to us.
- How do I fix the progress bar display on mobile? · Spacing, width and crowded tiers on phones are set in the Design page, with its own mobile view. Taps that do nothing in the gift chooser come from the theme.
Something missing? Write to support@yaco.studio, or try it first in the demo.