Description
RewardCrate is a free cart goal bar for WooCommerce. It shows shoppers
how far they are from the next reward, such as free shipping, a free gift or a
discount, and suggests the products that close that exact gap, with a
one-click add button right inside the bar. When a goal is reached, the reward
applies by itself.
Everything runs on your own WordPress site. There is no SaaS, no account to
create, no API key and no per-order fee.
Why store owners choose RewardCrate
- More than a free shipping bar. Set as many goals as you like, each with
its own reward: free shipping, a free gift product, or a percentage or fixed
discount. One progress bar shows every goal as a marker. - Suggestions that fit the gap. A shopper $16 away from free shipping sees
in-stock products priced to get them there, not random best sellers, and
adds one without leaving the cart. - Rewards that apply themselves. The gift drops into the cart at $0, the
discount applies with no coupon code to share, and shipping turns free at
checkout. - Buy 3, get the cheapest free. Bundle offers make the cheapest products
in a set free and repeat for every full set, so six products free the two
cheapest. They update live as the cart changes. - Let shoppers pick their gift. Offer up to six gifts on one goal; the
shopper chooses one in the bar and can swap it later. - Works with your cart. Classic and block cart and checkout, the
Mini-Cart block, product pages, a sticky bar, a shortcode and a block. - See it before you save. The settings screen shows a live preview of the
real bar and a goal ladder beside your goals, so you know exactly what
shoppers will see. - Shows what it earned. A Stats tab counts orders per goal, revenue from
suggested products and what the rewards cost you.
Perfect for
- Stores that want shoppers to reach the free shipping minimum.
- Raising average order value without a blanket sitewide discount.
- Gift-with-purchase promotions: “Spend $75, get a free sampler”.
- Tiered offers: free shipping at $50, a gift at $75, 10% off at $120.
- Mix-and-match deals: “Buy any 3 mugs, get the cheapest free”.
- Moving accessories and add-ons that complete a bigger purchase.
How it works
- Open WooCommerce > RewardCrate and add your goals: the cart amount
that unlocks each one, its label and its reward. The goal ladder and a
live preview beside them show the result as you type. - Choose where the bar shows: cart, checkout, Mini-Cart, a sticky bar on
every page, or anywhere you place the block or the[rewardcrate_goal]
shortcode. - Shoppers see their progress, the next reward and the products that close
the gap. The bar updates live as the cart changes. - A reached goal pays out by itself: free shipping at checkout, the gift line
at $0, or the discount, labelled with your goal’s name. - Check the Stats tab to see orders per goal, suggestion revenue, reward cost
and average order value.
Goals and rewards
- Unlimited goals, each unlocking free shipping, a free gift or a discount.
- Pause a goal without deleting it, or duplicate one to build the next rung.
- Free shipping: make the cheapest paid rate free, or follow the minimum
of your shipping zone’s own Free shipping method. - Free gift: any simple product or variation, added automatically at $0
with its quantity locked. A shopper who removes the gift is not given it
again for that goal. - Choose a free gift: offer up to six gifts on one goal. Shoppers who reach
it pick one from the goal bar, it goes in the cart at $0, and they can swap
it for another, all without a page reload. - Discount: a percentage or fixed amount, applied automatically and shown
under your goal’s name. Nothing to type, nothing to leak. - Goals are measured on the cart subtotal before discounts, so an unlocked
discount never pushes the cart back below its own goal. - Decide whether goal discounts combine with coupons marked “Individual use
only”.
Bundle offers
- Buy N, get the cheapest free: choose how many products make a set (2 to 10)
and how many of them are free. - Repeats for every full set (six products free the two cheapest), or cap the
sets per order. - A set can need different products, different variations, or any products,
so three of the same item count when you want them to. - Limit an offer to chosen products or categories, and leave products out.
- Applies by itself, recalculates as products are added or removed, and shows
its progress under the goal bar: “Add 1 more different product to unlock
Buy 3, get the cheapest free!”. - Goals are still measured before the offer, so a free product never costs a
shopper a goal they reached.
Gap-filler suggestions
- Products priced from the gap up to a ceiling you set (1 to 3 times the
gap), so suggestions actually unlock the next goal. Optionally also suggest
cheaper products that bring the shopper closer. - Show one to six suggestions at a time.
- Your pinned products first, then cross-sells and products from the same
categories as the cart, then best sellers. - Exclude products or whole categories. Out-of-stock, hidden and
already-in-cart products are never suggested. - One-click add from the bar in classic and block carts; variable products
link to their page unless exactly one variation fits. - Fast on large catalogues: it reads WooCommerce’s product lookup table and
caches the results.
Display
- Cart and checkout (classic and block), the Mini-Cart block drawer, product
pages (shown even before anything is in the cart), a dismissible sticky bar
at the top or bottom of the screen, a block for any page, and a shortcode. - Three bar styles (Card, Minimal and Bold), an optional striped fill, and a
reward icon on each goal’s marker: truck, gift, tag, percent, star, heart,
crown or bolt. - Eight ready-made colour palettes, or your own colours, including a fill for
when every goal is reached and the border, with a contrast check so the
message stays readable. - Corner roundness, bar thickness, text size, rounded or square bar ends,
left or centred text, full or narrow width, and whether goal labels and
amounts show under the bar. - Sticky bar on every screen size, desktop only or phones only, after a delay
you choose, and kept off the pages you pick. - Your own suggestions heading and Add button text, and a Custom CSS box for
anything else. - A celebration when a goal unlocks: confetti or a badge, never animated for
visitors who prefer reduced motion. - A live preview of the real bar sits beside the settings and follows every
change, for an empty cart, a cart on the way or one with every goal reached. - Your own messages for an empty cart, progress, each unlock and the end. Messages can name the amount still
needed, the goal’s own amount and its reward. - Keyboard and screen reader friendly, and translation ready.
Settings screen
- Everything on one screen under WooCommerce > RewardCrate, in tabs:
Goals, Offers, Gap-Filler, Display, Stats and Tools. - Goals on the left; the goal ladder and a live preview of the bar on the
right, side by side on wide screens. - Start from a ready-made goal set, then edit it.
- Inline checks on each goal: a duplicate amount or a missing gift is flagged
before you save. - A sticky header with the live status and goal count, and Ctrl+S (or ⌘S) to
save. The screen reopens on the tab you last used.
Stats
- Paid orders from the last 30 days: orders that reached a goal, revenue from
suggested products, reward cost (gifts, goal discounts and waived shipping)
and average order value. - Orders per goal, and orders that reached a goal or bought a suggestion
compared with those that did neither. - Counted once a day, or refreshed on demand.
- Stored in each order’s own data. No tracking, no external service.
Tools
- Export the settings to a file and import them on another store.
- Copy the
[rewardcrate_goal]shortcode. - Reset everything to the defaults; recorded stats are kept.
Built for modern WooCommerce
- High-Performance Order Storage (HPOS) and the Cart and Checkout blocks.
- No custom database tables and no external requests.
- Loads its scripts only on pages that show the bar.
Source code and build
The JavaScript in the build/ folder is compiled from the plugin’s own
human-readable source, which ships inside the plugin:
build/admin.jsfromresources/js/admin/index.tsx(the settings screen)build/widget.jsfromresources/js/widget.ts(the bar in classic carts, the mini-cart widget and the sticky bar)build/blocks.jsfromresources/js/blocks/cart-goal.tsx(the bar in the Cart and Checkout blocks)build/blocks-editor.jsfromresources/js/blocks/editor.tsx(the Cart goal block in the editor)build/goal-bar-editor.jsfromresources/js/blocks/goal-bar-editor.tsx(the standalone goal bar block in the editor)build/coupon-labels.jsfromresources/js/blocks/coupon-labels.ts(goal discount labels in the Cart and Checkout blocks)
Block metadata lives in resources/blocks/ and styles in resources/css/.
No third-party library is bundled: WordPress and WooCommerce packages are
loaded from the site at runtime.
To rebuild the files, install Node.js 20 or newer, then run npm install
and npm run build in the plugin folder. The build uses @wordpress/scripts
(webpack) with the included webpack.config.js.
Installation
- In your WordPress admin, go to Plugins > Add New, search for
RewardCrate, then install and activate it. WooCommerce must be active. - Open WooCommerce > RewardCrate.
- On the Goals tab, add a goal: the cart amount, a label and the reward.
Add as many as you like. - On the Display tab, choose where the bar shows and set its colours and
messages. - Save, add a product to your cart and watch the bar.
FAQ
Is RewardCrate free?
Yes. Every feature described here is in the free plugin, with no limits on
goals, products or orders.
Does it work with the block cart and checkout?
Yes. The bar appears in the Cart and Checkout blocks, where you can also move
it with the “Cart goal” block, and in the classic shortcode cart and
checkout.
Can I show the bar in the Mini-Cart?
Yes. With a block theme, open the Mini-Cart template part in the Site Editor
and add the “Cart goal” block to the drawer. Classic themes show it in the
WooCommerce mini-cart widget automatically.
How do I turn off the sticky bar?
Untick Sticky bar on every page on the Display tab, where you can
also move it to the bottom of the screen. Shoppers can also close it
themselves for the rest of their visit.
Can the bar show on product pages?
Yes. Tick Product pages, above Add to cart on the Display tab. It
shows even while the cart is empty, so shoppers see the first goal, such as
“Spend $50.00 to unlock Free Shipping!”, before they add anything. It works
in classic and block themes.
Does the discount push the cart back below its own goal?
No. Goals are measured on the cart subtotal before discounts, so an unlocked
discount stays unlocked.
What happens if the gift product goes out of stock?
The gift is skipped and the goal still shows as reached. The event is written
to the WooCommerce log under the source rewardcrate, once an hour per
product.
Can a shopper remove the free gift?
Yes. A removed gift is remembered for that visit and not added again for the
same goal. If the cart drops below the goal and reaches it again, the gift is
offered again.
Can shoppers choose their free gift from several?
Yes. In the goal’s card on the Goals tab, pick the first gift, then click
Add another gift to choose from for each other option (up to six). Once a
shopper reaches the goal, the bar shows the gifts with a Choose button;
the chosen one goes in the cart at $0, and choosing another swaps it. Only
one gift per goal is ever free. Out-of-stock options are not shown.
Can shoppers type a goal’s discount code?
No. Goal discounts are virtual coupons that only exist while their goal is
reached. Typed in by hand below the goal, they are rejected like any unknown
code.
Does it work with multi-currency plugins?
Goal amounts are saved in your store currency. When a currency plugin shows
the cart in another currency, convert each goal with the
smcc_threshold_amount filter, which receives the amount and the goal. Amounts
on the bar are formatted with WooCommerce’s own price format, so they follow
the shopper’s currency.
WPML with WooCommerce Multilingual:
add_filter( 'smcc_threshold_amount', function ( $amount ) {
return apply_filters( 'wcml_raw_price_amount', $amount );
} );
Aelia Currency Switcher:
add_filter( 'smcc_threshold_amount', function ( $amount ) {
return apply_filters( 'wc_aelia_cs_convert', $amount, get_option( 'woocommerce_currency' ), get_woocommerce_currency() );
} );
CURCY – Multi Currency for WooCommerce:
add_filter( 'smcc_threshold_amount', function ( $amount ) {
return function_exists( 'wmc_get_price' ) ? wmc_get_price( $amount ) : $amount;
} );
Suggested products follow the shopper’s currency on their own: the exchange
rate is measured from your products’ converted prices. To set it yourself,
return the price of one store-currency unit in the shopper’s currency from the
smcc_gap_filler_currency_rate filter.
How are the stats counted?
Each order placed while goals are on records the goals it reached, the cart
amount, the reward cost and the revenue from suggested products, in the
order’s own data. The Stats tab totals paid orders from the last 30 days,
refreshed once a day or on demand.
Is the higher average order value proof that the goals work?
Not on its own. The Stats tab compares orders that reached a goal or bought a
suggestion with orders that did neither, and shoppers who reach a goal may
have spent more anyway. It is a correlation, and the tab says so. Measuring
the real lift needs a holdout group that never sees the goals.
Can I change how the bar looks in my theme?
Yes. Set colours and messages on the Display tab, or copy
templates/goal-widget.php to yourtheme/rewardcrate/goal-widget.php
and edit it there.
Does it send data to an external service?
No. Everything runs on your own server and the plugin makes no remote
requests.
What happens if I uninstall it?
Its settings and cached data are removed from every site. The goal details
recorded on past orders are kept, because they are part of those orders’
history.
Is there a hook for developers?
Yes. Among others: smcc_goal_rules to change the goals per request,
smcc_should_display to hide the bar for a request while rewards still apply,
smcc_threshold_amount to convert amounts, smcc_tier_is_unlocked to veto
a goal, smcc_gap_filler_candidates and smcc_gap_filler_ranked to shape
suggestions, smcc_state_data to change what the bar receives, and the
smcc_order_recorded action after an order’s goals are stored.
Can I copy my goals to another store?
Yes. On the Tools tab, export the settings to a file and import it on the
other store, then save. Gift and pinned products are matched by ID, so check
them afterwards. The same tab resets everything to the defaults.
Screenshots














Changelog
1.5.2
- Fix: the number fields on the Offers tab can be cleared and retyped; they no longer snap to the lowest value while you type.
1.5.1
- Fix: bundle offers now save from the Offers tab; in 1.5.0 they were dropped when the settings were saved.
1.5.0
- New: bundle offers. “Buy 3, get the cheapest free” and similar: every full set of eligible products makes the cheapest ones free, so 6 products free the 2 cheapest. Choose the set size, how many are free, whether products must differ, eligible products or categories, and a limit per order. The discount updates as the cart changes and its progress shows under the goal bar, in classic and block carts.
- New: the Goals, Offers and Display tabs are laid out in two columns. Goals sit on the left with the goal ladder and a live preview of the bar on the right; on Display the settings sit on the left and the live preview stays in view on the right; Offers shows a worked example of how sets are counted.
- Tweak: a refreshed settings screen that uses the full width, with a vertical goal ladder that shows the step between goals and icon buttons to duplicate and remove.
- Tweak: the goal-widget.php template is at version 1.5.0; copy it again if your theme overrides it.
1.4.1
- Maintenance: republishes 1.4.0, the gift choice release, with no code changes.
1.4.0
- New: a gift goal can offer up to six gifts; shoppers who reach it choose one from the goal bar and can swap it, in classic and block carts.
- New: a single gift with “Add the gift to the cart automatically” off is now offered in the goal bar for the shopper to add.
- Tweak: the goal-widget.php template is at version 1.4.0; copy it again if your theme overrides it.
1.3.3
- Fix: suggested products now match the gap when a currency plugin shows the cart in another currency.
- Fix: with “Hide the bar while the cart is empty” off, the bar now shows on the empty cart page too, classic and block.
1.3.2
- Tweak: back to the original cart-and-gift icon, now also in the settings header.
1.3.1
- Tweak: a new icon and banner, with the same mark in the settings header.
1.3.0
- Add: corner roundness, bar thickness and text size controls.
- Add: rounded or square bar ends, left or centred text, and a narrow width.
- Add: hide the goal labels or amounts under the bar.
- Add: a fill colour for when every goal is reached, and a border colour.
- Add: show the sticky bar on desktop or phones only, after a delay, and keep it off chosen pages.
- Add: your own suggestions heading and Add button text.
- Add: a Custom CSS box on the Display tab.
- Tweak: new listing screenshots of the redesigned bar and settings.
1.2.0
- Add: reward icons on the bar, with an icon to choose per goal.
- Add: Card, Minimal and Bold bar styles, and an optional striped fill.
- Add: eight colour palettes and a contrast check on the Display tab.
- Add: the goal bar on product pages, shown even with an empty cart.
- Add: a message for the empty cart, with the
{goal}placeholder. - Add: the sticky bar can sit at the bottom of the screen.
- Enhance: the Display tab previews the real bar for an empty cart, a cart on its way and a finished cart.
- Enhance: a new brand mark in the settings header.
1.1.0
- Add: pause a goal without deleting it; paused goals keep their stats.
- Add: duplicate a goal, and start from a ready-made goal set.
- Add: Tools tab to export, import and reset the settings, and copy the shortcode.
- Add:
{goal}message placeholder for the cart amount that unlocks a goal. - Add:
smcc_should_displayfilter to hide the bar for a request. - Add: Settings link on the Plugins screen.
- Enhance: redesigned settings screen with a sticky header, live status, a goal ladder, inline checks on each goal and Ctrl+S to save.
- Enhance: the settings screen reopens on the tab you last used.
- Fix: the message preview replaced only the first copy of a placeholder.
1.0.0
- Initial release.
