This is the main text shown while the customer has not yet reached free shipping. You write one template per language; the module fills in live values on every page load and after each cart update.

What it does: Replaces placeholders with the current remaining amount, threshold, cart total, progress percentage, country code, customer group, A/B variant label, and currency—formatted for the visitor’s context.

Why it helps: Shoppers see exactly how much is left (“Only €14.20 left to unlock free shipping!”) instead of a vague promise. That clarity reduces abandonment and nudges them to add one more item. You can easily insert dynamic placeholders to personalize the experience: [amount], [threshold], [cart_total], [progress_percent], [remaining_percent], [country], [group_id], [variant], [currency].

Shown when the cart total meets or exceeds the active free-shipping threshold for that visitor. The progress bar fills to 100% and the dynamic template is replaced by your celebration copy.

Why it helps: Confirms the reward immediately—“Great news! You have unlocked free shipping”—so customers feel they achieved something and proceed to checkout with confidence. Supports the same placeholders if you want to repeat the threshold or cart total in the success line.

Smart (cart-aware): The module searches your catalog for a product that fits the cart’s categories and is priced close to the missing amount needed for free shipping. It displays the product name, link, and price below the bar.

Manual product ID: You always show one fixed product you choose—useful when you want to promote a specific add-on (samples, warranty, bestseller pouch) regardless of cart content.

Why it helps: Smart mode turns the progress bar into a guided upsell: one relevant product that closes the gap, not a random cross-sell. That typically converts better than showing unrelated items.

Enter the PrestaShop product ID used when upsell mode is manual, or as a fallback when smart mode cannot find a suitable product in the catalog.

Why it helps: You never show an empty upsell block. Even with a sparse catalog or unusual cart, you can fall back to a safe default product you know ships well and margins accept.

None: Static bar—minimal distraction, best for very clean themes.

Smooth: Gentle transition when the fill percentage changes after cart updates.

Pulse: Subtle pulsing on the progress fill to draw attention without being aggressive.

Why it helps: Motion signals that the bar is live and tied to the cart, which reinforces the “almost there” feeling and can increase add-to-cart on the next product.

Choose the pictogram next to the message: Truck (delivery focus), Gift (reward focus), or Star (premium / special offer tone).

Why it helps: A small visual cue makes the bar scannable in busy headers or cart areas. You match the mood of your brand without custom graphics.

Auto detect: The module adapts styling hooks to the active theme when possible.

Classic or Hummingbird: Force compatibility profile for PrestaShop’s main theme families when auto detection is not enough.

Why it helps: The bar looks native on the storefront—correct spacing and contrast—without editing theme templates.

When no delivery address exists yet, the module uses PrestaShop’s built-in country detection (GeoIP) to guess the visitor’s country and apply the matching country rule from Targeting.

Why it helps: International shops show the correct free-shipping target from the first page view—not a generic default that confuses foreign buyers.

Optional second layer. Called only if PrestaShop geolocation does not return a country. Useful on hosts where native GeoIP is disabled or inaccurate.

Why it helps: More reliable country rules for guests without forcing them to select country manually at the start of the visit.

Endpoint template for the external service. Must include %s where the visitor IP is inserted (example format: https://ipapi.co/%s/country/).

Why it helps: You stay in control of which provider you trust and can switch APIs without code changes.

Maximum wait time for the external GeoIP request. Keeps the storefront fast if the API is slow or down.

Why it helps: Protects page performance— the bar still appears using fallback logic instead of blocking the shop.

The shop-wide minimum cart value (products only, shipping excluded) required for free delivery when no country rule and no customer-group rule applies.

Why it helps: One safety net for all visitors. Amounts are entered in the shop default currency and converted automatically when the customer switches currency—so mult currency stores stay consistent.

Interactive list of all active countries. Click a country on the left to add it to your rules; set an individual free-shipping threshold for each on the right. Search helps large catalogs.

What it does: Stores rules as structured data (country ISO code + threshold). When the module resolves the visitor’s country, it uses the matching rule instead of the default.

Why it helps: Run fair economics per market—higher threshold for remote countries, lower for domestic—without separate shops or manual theme edits. Removes “remove all rules” when you need to reset quickly.

Same workflow as countries: pick a group (VIP, wholesale, employees, etc.) and assign its own threshold. Search and bulk remove are built in.

Why it helps: Reward loyal or B2B buyers with a lower free-shipping bar while keeping a higher bar for retail guests—directly in the progress message they see while shopping.

Three sources, in your chosen order:

• Delivery address — country from the cart’s delivery address when available.
• Invoice address — fallback to invoice country if delivery is not set.
• GeoIP — geolocation from Settings when addresses are missing (guest browsing).

Why it helps: You control legal and commercial logic explicitly—e.g. prioritize delivery country at checkout but GeoIP on the homepage—so the bar always shows the threshold you intend for that moment in the journey.

A real-time rendering of the bar as customers will see it, using your current design settings and sample copy.

Why it helps: You design with confidence—colours, radius, and typography are WYSIWYG before publishing.

Sets the simulated free-shipping target in the preview (e.g. €64) so you can see how the bar looks at different goal levels.

Add or subtract a value from the preview cart total to mimic products being added or removed. Triggers progress recalculation and, when enabled, the update effect animations—exactly as on the live shop after AJAX cart refresh.

Why it helps: You tune motion and colours while watching the bar react, not guessing from static screenshots.

Background color or gradient (on/off with start/end colours) for the card behind the message and bar.

Border color & width and radius shape the container—from flat minimal strips to soft rounded cards.

Shadow (on/off) adds depth so the bar stands out in the header or cart.

Padding Y / Padding X control internal spacing; max width (0 = full width) keeps the bar readable on ultra-wide layouts.

Why it helps: The progress block matches your brand guidelines instead of looking like a generic plugin dropped into the theme.

Typography and layout of the main line: left, center, or right aligned.

Show icon toggles the truck/gift/star from Settings independently of text; icon size scales it for mobile headers or large cart panels.

Why it helps: Readable on small screens, prominent on desktop—without conflicting with theme fonts if you align sizes deliberately.

Bar height and track color/radius define the empty part of the meter.

Fill color or gradient fill (two colours) is the completed portion—your brand accent or a conversion-focused highlight.

Stripes (on/off) add a subtle animated pattern on the fill for extra visibility.

Why it helps: The progress line becomes a branded UI element customers recognise across pages, not a default grey Bootstrap bar.

Show goal badge displays a compact pill (e.g. threshold summary) next to the message when enabled.

Badge background & text colour style that pill.

Show upsell toggles the product suggestion block from Settings without disabling upsell logic entirely.

Upsell font size & colour keep the recommendation readable but secondary to the main message.

Why it helps: You can run a message-only bar on minimalist themes, or a rich bar with badge + product link where space allows.

When enabled, the whole bar card briefly wiggles, flashes, and shows a glint across the progress track after each cart update (add, remove, quantity change) on the storefront.

Why it helps: Draws the eye to progress moving upward—“you are closer now”—which reinforces the goal without pop-ups.

Controls how long the container shake lasts and how many pixels it moves horizontally. Short and subtle feels premium; longer reads more playful.

A light sweep across the card: colour, how bright the peak is, and how wide the bright band is. Tuned to match brand highlights or seasonal campaigns.

A moving shine along the progress track—duration and stripe width in pixels—so the fill itself feels “charged” when the cart grows.

Visible in the main header nav area on every page where the hook runs. Enabled by default. Ideal for reminding guests of free shipping while they browse categories.

Secondary header row on themes that split navigation. Use when the primary row is crowded but you still want top-of-page visibility.

Full-width area below the header on many Classic layouts. Strong visibility without sitting inside the menu links.

Very top of the document. Useful for sticky-style campaigns or themes with minimal header hooks.

Home page content zone. Sets expectations before the customer opens a product—especially effective with country-based thresholds.

Sidebar on catalog and CMS pages. Keeps the goal visible while filtering categories (themes with a left column).

Same as left column for right-sidebar layouts. Pair with cart block if your theme stacks widgets there.

Under product actions on the product sheet. Shows how this item contributes to free shipping while the buyer decides quantity.

PrestaShop reassurance zone (trust badges area). Positions free shipping as a trust benefit next to returns or security icons.

Bottom of the cart page. Enabled by default. Highest intent: the customer is reviewing the basket—perfect moment for remaining amount + upsell.

Inside the cart summary block (mini-cart or full cart, depending on theme). Keeps progress visible next to totals.

Strip above the site footer on pages that expose this hook. Last chance reminder before the customer leaves the page.

Inside the footer column area. Lower prominence but always on wide layouts that render footer hooks globally.

Checkout funnel beside subtotal lines. Reduces surprises at the last step—“you are €3 away” right where payment decisions happen.

Adds a second instance fixed to the bottom of the viewport on all pages (in addition to any hook-based instances you enabled). Stays visible while scrolling on mobile and desktop.

Why it helps: Many buyers never return to the cart drawer after adding a product. A persistent bar keeps the free-shipping goal in view until they complete the threshold—especially powerful together with smart upsell.

Turns on automatic rotation between message variants instead of always showing the default dynamic template from Settings. Each visitor is assigned a variant for the session; impressions and conversions are recorded.

Why it helps: Small copy changes (“Only [amount] left” vs “Add [amount] more for free delivery”) can shift average order value—you measure it with data, not gut feeling.

Three independent message templates per language, each supporting the same placeholders as the main dynamic message. Example angles: urgency, reward framing, or percent complete ([progress_percent]).

Why it helps: Run proper multivariate copy tests without duplicate modules or theme hacks.

Traffic split between variants (e.g. 40% / 35% / 25%). Controls how often each message is shown to new sessions.

Why it helps: You can favour a promising variant while still gathering data on challengers, or evenly split for a clean three-way test.

Visual report of impressions, conversions, and conversion rate per variant (A, B, C, or default when A/B is off). A conversion is recorded when the customer’s cart reaches the free-shipping threshold; an impression is counted when they see the bar.

Why it helps: You pick the winning message and disable weaker variants—direct impact on revenue per visitor.

Running counter of how many times shoppers hit the goal (all variants combined). Shows whether your threshold and placement strategy are achievable in practice—not just how many people saw the bar.

Why it helps: If impressions are high but goal hits are low, you may lower a threshold, improve upsell, or test sharper copy—using one number the whole team understands.