User Guide

Search limit to:






Discount progress bar

by Admin on Sep 12, 2025

1. Overview

1.1. What is the Discount Progress Bar?

The Discount Progress Bar is a dynamic visual element that guides customers through quantity-based discount tiers. It updates in real-time to show customers how close they are to unlocking the next discount based on their cart quantity.

Key characteristics:

  • 🎯 When to use: Guide customers through quantity-based or subtotal-based discount tiers.
  • ⚙️ How it works: Updates in real time to show customers how close they are to unlocking the next discount based on quantity or subtotal.
  • 📍 Setup location: A block under Product information/Featured product/Quick view section.

1.2. Supported discount types

The Discount progress bar feature supports two types of discount codes:

✅ Quantity-based Discounts

  • Discounts are triggered when customers buy a certain number of items.
  • Example: Buy 10+ items → Get $5 off, Buy 20+ items → Get $10 off
  • Best for: Wholesale offers, bundle deals, “buy more, save more” campaigns.

→ Go to 3.1. How to set up a Discount progress bar using QUANTITY OFF DISCOUNT? to learn more

Purchase Amount Off Discounts

  • Discounts are triggered when customers spend a certain amount of money.
  • Example: Spend $100 → Get $10 off, Spend $200 → Get $25 off
  • Best for: Cart-value upsell strategies, free gift thresholds, or tiered BFCM promotions.

→ Go to 3.2. How to set up a Discount progress bar using PURCHASE AMOUNT OFF DISCOUNT? to learn more

2. 🚨 CRITICAL: Before you start

Setting up the Discount progress bar requires TWO ESSENTIAL PROCESSES:

  • Process 1: Create discount codes in Shopify Admin (the actual discounts customers can use) 
  • Process 2: Configure the progress bar in Theme Editor (the visual display showing discount tiers)
⚠️ IMPORTANT: The discount values in Shopify Admin MUST EXACTLY MATCH the goal values in Theme Editor, or buyers might be confused.

3. Step-by-step setup

3.1. How to set up a Discount progress bar using QUANTITY OFF DISCOUNT?

Process 1: Create discount codes in Shopify Admin

STEP 1: Go to Shopify Admin → Discounts → Create discount

STEP 2: Choose the "Amount off products" discount type. If you want to offer free shipping as a discount goal, choose Free shipping discount type.

STEP 3: Make sure you choose "Automatic discount".

STEP 4: Set the Discount value (this will be displayed in your progress bar), and the Eligibility of the discount.

STEP 5: Set the Minimum purchase requirements > tick Minimum quantity of items > fill in the required number (this will be displayed in your progress bar as well).

STEP 6: Click "Save".

STEP 7: Repeat for each tier (create a separate discount for each goal)

Example setup: If you want 5 discount tiers, create 5 automatic discounts:

  • Discount 1: $5 off when buying 10+ items
  • Discount 2: $10 off when buying 20+ items
  • Discount 3: $15 off when buying 30+ items
  • Discount 4: $20 off when buying 40+ items
  • Discount 5: $25 off when buying 50+ items

Process 2: Set up the Progress Bar in Theme Editor

STEP 1: Add the Discount progress bar block

Navigate to the Product page, under the Product information section, add the Discount progress bar block

STEP 2: Choose the discount type

At Discount type, choose the Items quantity option.

STEP 3: Match the goals

Click on the Discount progress bar to open the settings panel. Scroll down to the Goal 1 section and fill in the values:

Field name

What to fill in? How it appears
Goal 1

Enter the exact threshold you set earlier in Shopify admin (e.g., 10)

Goal 1 label Enter discount description for the tiers table (e.g., "$5 off each")
Goal 1 pre-goal message

- Message shown BEFORE goal is reached. 

- Use these placeholders to add dynamic value: 

[x] = automatically shows the remaining quantity needed.

[goal_label] = automatically shows the goal label you entered

How it works for customers:

  • Goal condition: 10 items needed for $5 off each
  • Current cart: 5 items
  • Pre-goal message displayed

Goal 1 post-goal message Message shown AFTER reaching goal. Use [goal_label] placeholder

How it works for customers:

  • Goal condition: 10 items needed for $5 off each
  • Current cart: 10 items
  • Post-goal message displayed

STEP 4: Repeat these steps for goals 2,3,4,5.

⚠️ Note: If you enter a smaller goal after a larger one, the system will automatically reorder the goals on the bar to ensure they are displayed in the correct sequence.

STEP 4: Click "Save" when done.

Process 3: Final refinements

After finishing the two most important processes above, just a few works are left to make your Discount progress bar “glorious”:

STEP 1: Add a Heading (e.g., "Buy more get more!")

STEP 2: Decide where the block applies:

For specific products → select products under Apply to products.

For specific collections → select collections under Apply to collections.

For all products and collections → leave both fields empty.

STEP 3: Choose how the discount progress is tracked

At Progress calculation method, choose among:

  • Per product: Customers must reach the discount threshold within a single product for the bar to move forward.

👉For example: If the discount requires buying 5 items, and the customer adds 3 product A and 2 product B, the bar won’t move. But if they add 5 product A, the bar will progress.

  • Combined total: Progress is tracked based on the total quantity across all selected products/collections in the cart.

👉For example: If the discount requires 5 items, the customer can add 3 product A + 2 product B. Since the total quantity is 5, the bar will progress.

STEP 4: Save your settings

3.2. How to set up a Discount progress bar using PURCHASE AMOUNT OFF DISCOUNT?

Process 1: Create discount codes in Shopify Admin

STEP 1: Go to Shopify Admin → Discounts → Create discount

STEP 2: Choose the "Amount off products" discount type. If you want to offer free shipping as a discount goal, choose Free shipping discount type.

STEP 3: Make sure you choose "Automatic discount".

STEP 4: Set the Discount value (this will be displayed in your progress bar), and the Eligibility of the discount.

STEP 5: Set the Minimum purchase requirements > tick Minimum purchase amount > fill in the required number (this will be displayed in your progress bar as well).

STEP 6: Click "Save".

STEP 7: Repeat for each tier (create a separate discount for each goal)

Example setup: If you want 5 discount tiers, create 5 automatic discounts:

  • Discount 1: 5% off when spending $100
  • Discount 2: 10% off when spending $200
  • Discount 3: 15% off when spending $300
  • Discount 4: 20% off when spending $400
  • Discount 5: 25% off when spending $500

Process 2: Set up the Progress Bar in Theme Editor

STEP 1: Add the Discount progress bar block

Navigate to the Product page, under the Product information section, add the Discount progress bar block

STEP 2: Choose the discount type

At Discount type, choose the Items purchase amount option.

STEP 3: Match the goals

Click on the Discount progress bar to open the settings panel. Scroll down to the Goal 1 section and fill in the values:

Field name

What to fill in? How it appears
Goal 1

Enter the exact threshold you set earlier in Shopify admin (e.g., 100)

Amount entry formats:

  • Amount only (e.g., 100) - Applies to all countries and currencies universally
  • Currency code with amount (e.g., USD:100) - Applies to any country that uses the specified currency (USD in this example)
  • Country code with currency and amount (e.g., US:USD:100) - Applies only to the specific country with the specified currency (United States with USD in this example)

👉Add one rule per line only.  

Goal 1 label

Enter discount description for the tiers table (e.g., "5% off")

Goal 1 pre-goal message

- Enter the message shown BEFORE the goal is reached. 

- Use these placeholders to add dynamic value:

[x] = automatically shows the remaining quantity needed

[goal_label] = automatically shows the goal label you entered

How it works for customers:

  • Goal condition: Spend 100đ to get 5% off
  • Current cart: 94đ subtotal 
  • Pre-goal message displayed

Goal 1 post-goal message

- Enter the message shown after reaching the goal

- Use these placeholders to add dynamic value:

[goal_label] = automatically shows the goal label you entered

How it works for customers:

  • Goal condition: Spend 100đ to get 5% off
  • Current cart: 100đ subtotal 
  • Post-goal message displayed

STEP 4: Repeat these steps for goals 2,3,4,5.

⚠️ Note: If you enter a smaller goal after a larger one, the system will automatically reorder the goals on the bar to ensure they are displayed in the correct sequence.

STEP 5: Click "Save" when done.

Process 3: Final refinements

After finishing the two most important processes above, just a few works are left to refine your Discount progress bar:

STEP 1: Add a Heading (e.g., "Buy more get more!")

STEP 2: Decide where the block applies:

  • For specific products → select products under Apply to products.
  • For specific collections → select collections under Apply to collections.
  • For all products and collections → leave both fields empty.

STEP 3: Choose how the discount progress is tracked

At Progress calculation method, choose among:

  • Per product: Customers must reach the discount threshold within a single product for the bar to move forward.

👉For example: If the discount gives $10 off when spending $100 on the same item, spending $50 on Product A and $50 on Product B won't count. However, if customers spend $100 on Product A alone, the bar will progress.

  • Combined total: Progress is tracked based on the total quantity across all selected products/collections in the cart.

👉For example: If the discount gives $10 off when spending $100, customers can spend $50 on Product A + $50 on Product B. Since the combined subtotal reaches $100, the bar will progress.

STEP 4: Save your settings

4. Advanced customizations

📂 Icon 

STEP 1: Toggle "Show progress bar icons" to show icons

STEP 2: Adjust Icon size

STEP 3: For each goal, customize:

  • Goal icon: Choose from dropdown, upload image, or enter SVG code
  • Goal reached icon: Icon displayed after reaching the goal

✅ As a result, you have a discount progress bar with each goal and its separate icon

📂 Discount Tiers Table 

STEP 1: Toggle "Show discount tiers table"

STEP 2: The table displays:

  • Left column shows Goal value
  • Right column shows Goal label

STEP 3: Customize column labels as needed

📂 Color Customization

Customize colors for various elements:

  • Heading
  • Text
  • Background
  • Available for both light and dark theme modes

5. Support Information

Need help? Contact our support team at Omni Themes Support.