Cart Quantity Goal Setup Guide
For a three-item cart goal, one line with quantity three and three lines with quantity one each should reach the same total-quantity milestone. Removing one unit should reverse it. This BlueCart tutorial tests quantities, cart lines, and the actual reward rules separately.
Setup tutorial · BlueCart · Updated 2026-09-07 · By Activory
Try the storefront example
Change the sample item count. Test a value below each goal, exactly at the goal, and above it. Reduce the value to check that the message returns to the earlier state.
This example uses BlueCart storefront code with sample data and the settings below. Your theme’s fonts and available width can change the result. Example links show their destination; purchase controls use a sample cart. Use the checks below to confirm the finished setup in your store.
Build it in BlueCart
- Open BlueCart and create a progress bar campaign. Give it a name that identifies the offer.
- Set measurement to By cart quantity. Add the goals and messages listed below. Keep
{remaining}in the progress message so BlueCart calculates the gap. - In Display options, choose Progress bar only for desktop and mobile. Use a white container with medium rounded corners and blue progress colour (#2563eb).
- Save and publish the campaign. Enable the BlueCart app embed in your theme. Add the BlueCart app block at the intended location and select this campaign. For a custom placement, use the campaign’s generated shortcode.
For a custom BlueCart placement, replace YOUR_CAMPAIGN_ID with the ID from your saved campaign. Keep the app embed enabled.
<div class="bcpb-bluecart" data-id="YOUR_CAMPAIGN_ID"></div>
Example settings
- Goal 3: Three-item goal. Bottom progress message: Add
{remaining}items to reach this goal. Completed message: Three-item goal goal reached.
Sample data and content
Use these values for a test. Replace them with checked product data, published destinations, and offers that your store can supply.
| Cart setup | Total units | Distinct lines | Expected goal state | Reason |
|---|---|---|---|---|
| One item with quantity 1 | 1 | 1 | Below three-item goal | Basic starting case |
| One item with quantity 2 | 2 | 1 | One unit remaining | Count units not lines |
| One item with quantity 3 | 3 | 1 | Goal reached | Repeated quantity boundary |
| Three items with quantity 1 each | 3 | 3 | Goal reached | Multiple line boundary |
| Remove one unit from a qualifying cart | 2 | Varies | Goal no longer reached | Recovery after removal |
Should a quantity goal count all items or only eligible products?
Define whether the offer covers total cart quantity or a restricted product set. A count-based progress campaign and a product-specific discount can disagree if they count different items. Use offer wording that matches the supported campaign calculation and the real checkout reward.
- Choose a cart-quantity campaign in BlueCart and define the reward that corresponds to the unit goal.
- Configure the reward independently and confirm its eligible items match the progress calculation.
- Test the single-line quantity cases, then the multiple-line cases. Use the setup guide to record both message and checkout outcomes.
- Change quantity through the theme’s cart controls and through a cart drawer if your storefront has one.
Read the BlueCart setup guide for the full app controls and placement options.
Check the finished setup
- Increase a line from quantity two to three and confirm the goal changes once the cart update completes.
- Remove a qualifying unit and check that an old success message does not remain.
- Add an item outside a restricted offer and inspect whether the campaign count still matches the discount eligibility.
Common mistakes
- Do not call a total-quantity goal a distinct-product goal.
- Do not advertise a collection-only reward with an unrestricted count unless you can make the rules agree.
Supported use
These examples cover progress messages and cart recommendations. A displayed milestone does not prove that checkout grants a reward. Confirm the actual shipping rate or discount with a test order, including cart changes and competing discounts. Sample amounts are teaching examples, not recommended thresholds or revenue forecasts.
BlueCart features, current app plans, and Shopify discount combinations explain the supported setup.
Related tutorials
- Tiered Discount Campaign Setup Guide
- Reward Checklist Message Setup Guide
- Cart Upsell Pairing Setup Guide
Browse all BlueCart tutorials. Read how the examples are made or report a correction.