Find the article you need - by question
Categories are organized for someone who already understands the product. If you don't - if you're just trying to do a thing - this page is for you. Find the question that matches what you're trying to do, click through.
If your question isn't here, the full FAQ mirrors the in-app help drawer. Still stuck? valentin@valotrix.com.
I want to...
Add a free gift over $50
Pick the Spend threshold gift template when creating a campaign, set the cart-subtotal threshold to $50, and pick a gift variant. Walkthrough: Spend $50, get a free tote.
Run BOGO (buy one, get one free)
Use the trigger "Cart has a product from collection X" or "Cart has a specific product", with the gift product as the reward. See Buy one, get one (BOGO).
Run a tiered promotion ($50 / $100 / $200, more gifts each tier)
Create one campaign with multiple rules - one rule per tier. See Tiered: spend $50 / $100 / $200.
Run a flash sale with a gift on a specific date
Schedule the campaign via the Schedule field on the campaign edit page, or use Shopify Flow's Scheduled time trigger to enable / disable. See Seasonal scheduled campaigns and Flow recipes.
Reward VIP customers only
Add a customer-tag condition (e.g. customer has tag vip) to your rule. See VIP-only campaigns and Customer targeting.
Geo-target a campaign (only in EU, only in the US)
Add a country or market condition to your rule. See Geo-targeted campaigns and Multi-currency & Markets.
Offer the customer a choice of gifts (instead of auto-adding)
Switch the reward type to Customer choice and configure 2+ gift options. The gift-choice modal opens at the configured trigger. See Customer choice popup.
Reward subscription orders
Add a "Cart contains a subscription product" condition. See Subscription bonus.
Cap how many times one customer can claim a gift
Per-rule per-customer limits, with optional lifetime or window cap. See Per-customer limits.
Show a progress bar at the top of every page
Place a Threshold bar Custom Block in your theme header section. See Custom Blocks.
Show a "Free gift" badge on collection grid cards
Place a Collection eligibility overlay Custom Block on your collection template. See Custom Blocks → Collection eligibility overlay.
Build a custom analytics dashboard on top of Valotrix Cart Rewards data
Scale plan unlocks the public REST API. See Public REST API.
Get notified when a gift is added or an order converts
Subscribe to outbound webhooks (Scale plan). 9 event types including gift.added, gift.removed, order.converted. See Webhooks.
How do I...
Switch from a free-shipping threshold to a free-gift threshold?
Pause the Shopify shipping promo, create a Valotrix Cart Rewards gift campaign at the same threshold, run a 2-week A/B or before/after comparison. See Free shipping → free gift.
Migrate from BOGOS, Monster GWP, or Bold Brain?
Install Valotrix Cart Rewards in parallel, re-create your top 3 promos, run a 24-hour overlap, then uninstall the old app. See Migrating from another app.
Customize a widget's HTML, CSS, or JavaScript?
Scale plan unlocks per-widget HTML / CSS / JS overrides. See Custom code.
Add a threshold bar to my home page (not just the cart drawer)?
Use the Threshold bar Custom Block. Place it in any theme section that accepts blocks. See Custom Blocks.
Use A/B testing to pick the better threshold or gift?
Scale plan unlocks the experiments feature. Pick two rules of the same campaign as control + variant. See A/B testing.
Translate widget copy for non-English markets?
Per-locale overrides in the Messaging tab of the rule editor. See Translations.
Show different messaging on mobile vs desktop?
Per-form-factor overrides on the Messaging tab. See Mobile overrides.
Enable the theme app embed?
Online Store → Themes → Customize → App embeds → toggle Valotrix Cart Rewards on. See Enable theme app embed.
Preview a campaign before going live?
Click Preview on the campaign edit page. A 24-hour signed preview link opens - only you see the draft campaign on the real storefront. See Preview before going live.
Automate campaign on/off with Shopify Flow?
Two Flow actions: Enable promotion campaign and Disable promotion campaign. Two Flow triggers: Promotion gift added and Promotion order converted. See Flow recipes.
Stop $0 checkouts from reaching the order step?
Settings → Checkout → "Stop $0 checkouts". See Settings.
Make the gift cart row say "Free" instead of "$0.00"?
Settings → Gift line display → "Show 'Free' label". Applies globally. See Settings.
Cancel my plan or downgrade?
Settings → Plan → Downgrade. Or uninstall the app from Shopify Admin → Apps. See Plans, billing & cancellation.
Build a campaign on a headless storefront?
Use the public REST API to read rules + the events ingest endpoint to send gift events. See Headless storefronts.
Why isn't this working?
The gift didn't add for a customer who hit the threshold
Walk the four diagnostic checks: campaign enabled, simulator agrees, theme app embed on, storefront debug log. See Gift not added.
The gift line is missing from my cart drawer (but appears on the cart page)
A third-party cart-drawer app or theme JS is stripping line properties. Three fix paths. See Theme breaks gift line.
Customers using Buy Now or Shop Pay aren't getting the gift
Express-checkout bypass behavior + the engine option that fires on cart submission. See Buy Now / Shop Pay bypass.
My gift product went out of stock - what happens?
Auto-disable on stockout (runs on every plan; the email alert is Pro $49/mo+), the "Continue if a gift is out of stock" override toggle, fallback gift configuration, restock notifications. See Out-of-stock gifts.
The simulator says the rule fires but production doesn't
Simulator vs production behavior, what the simulator can't catch, the ?vltrx_debug=true debug overlay. See Simulator deep-dive.
The simulator says no rule matched but I expected it to
Switch to Developer mode in the simulator - it shows per-condition pass/fail with values. See Simulator deep-dive.
The widget shows up but doesn't match my brand
Customize colors, fonts, copy, and animation timing in the Messaging tab of the rule editor. For full HTML / CSS / JS replacement, Custom code (Scale plan).
My A/B test results don't look statistically significant
Wait longer. The Bayesian "chance to win" reads update continuously. See A/B testing for what 95% credibility means and when to call a winner.
I hit my plan cap - what now?
Pause inactive campaigns, archive old rules, or upgrade. See Plan cap safety.
The cart drawer flashes the threshold bar then it disappears
Almost always a competing cart-drawer app re-rendering the cart HTML. See Theme breaks gift line.
The widget isn't visible at all
Theme app embed off, campaign disabled, or no rule matches the visitor's cart. Walk Gift not added - same diagnostic flow.
I'm comparing...
Valotrix Cart Rewards vs BOGOS, Monster GWP, or Bold Brain
Discount mechanism (Functions vs $0 variants), flat pricing, what we don't try to do, where we're heavier. See How Valotrix Cart Rewards compares.
Which plan should I be on?
Single recurring promo → Free. Multiple campaigns + storefront polish → Growth $24/mo. Per-customer limits, geo, discount-code-aware → Pro $49/mo. A/B testing, REST API, webhooks → Scale $99/mo. See Plans, billing & cancellation.
Widgets vs Custom Blocks - which do I use?
Widget = overlay (toast, popup, drawer progress); Block = inline (PDP, collection grid, header). You can use both. See Blocks vs Widgets.
Automatic discount vs discount code
Automatic applies at checkout with no code typing - recommended default. Discount code requires the customer to type a code at checkout - useful when you want to limit redemptions by code distribution. See Rewards & discounts.
Single-tier vs multi-tier promotion
Multi-tier ($50 / $100 / $200) drives more AOV lift in most categories. Single-tier is simpler to communicate. See Tiered rewards and Tiered spend recipe.
Auto-add gift vs customer-choice popup
Auto-add is simpler and converts better in most cases. Customer-choice is right when you have 2+ gifts of comparable value and want the buyer to feel in control. See Customer choice popup.
Can't find your question? The full FAQ covers 22 more from the in-app help drawer. Or email valentin@valotrix.com - solo founder support, EU business hours, same-day response on weekdays.