Skip to main content

A gift isn't being added - diagnostic flow

If a customer hits the threshold but no gift appears, run through these four checks in order. The first one that fails is almost always the answer.

Check 1 - Is the campaign enabled?​

In the campaign list, confirm the toggle is on (green). A campaign saved with the toggle off doesn't fire even if the conditions match. Also confirm the campaign isn't paused, scheduled, or expired - the campaign-list status pill shows the current state.

Check 2 - Does the simulator agree?​

Open the Simulator in the admin sidebar and rebuild the customer's cart: same products, same quantities, same logged-in state, same currency / market if applicable. Click Run Simulation.

If the simulator says no rule matched, the trigger logic doesn't match the cart you tested - re-check your conditions. The Easy simulator's results panel summarizes which rule matched and why; for engine-level traces (every condition's pass/fail with values), switch to Developer mode at the top of the page.

If the simulator does say the rule should match but the live cart isn't getting the gift, that's a storefront-engine issue - go to Check 3.

Check 3 - Is the theme app embed enabled?​

Valotrix Cart Rewards's storefront script runs through Shopify's App embeds mechanism. If the embed toggle is off in your live theme, the script never loads, and no gift gets added on a matching cart.

In Shopify Admin → Online Store → Themes → Customize → App embeds (left rail), confirm Valotrix Cart Rewards is toggled on. Save the theme. See Enable the theme app embed for the full walkthrough.

Check 4 - Open the storefront debug log​

Add ?vltrx_debug=true to the end of a storefront URL (e.g. https://yourshop.com/?vltrx_debug=true) and open the browser console. With the flag on, Valotrix Cart Rewards prints a detailed log on every cart change: which rules were evaluated, which conditions passed or failed, what the current cart subtotal is, and why a particular gift was or wasn't added.

This is the same log the Developer simulator shows you - the difference is that you're now reading it from a real cart on the real storefront. That catches theme-specific issues the simulator can't see, such as a theme that handles cart updates in an unusual way, or a custom cart drawer that re-renders without picking up the gift Valotrix Cart Rewards just added.

Still stuck?​

Email valentin@valotrix.com with:

  • Your Shopify store URL
  • The campaign ID (visible in the admin URL: /app/campaigns/<id>)
  • A screenshot of the simulator result with the same cart shape
  • The browser console output with ?vltrx_debug=true attached
  • A description of what the customer did

Solo founder support, EU business hours; same-day response on weekdays.

Next: Why aren't gifts added on Buy Now / Shop Pay? →