Settings
The Settings page (admin sidebar -> Settings) is where you fine-tune Valotrix Cart Rewards's shop-wide behavior. Most defaults are tuned for the typical store - you can install Valotrix Cart Rewards and never open Settings. The sections below walk through what each toggle does in case you want to dig in.
The page is organized into six top-level cards, plus a separate Gift line display sub-page reachable from this Settings screen:
- Gift Delivery - how and when the storefront engine evaluates carts.
- Cart Integrity - guards that stop customers checking out with only free stuff.
- Preview features - experimental settings, including Post-Checkout Repair.
- Monitoring & Alerts - in-app health badges and email reports.
- Data & Privacy - retention windows and session tracking.
- API & Webhooks - developer keys and outbound delivery endpoints (Scale plan).
Gift Delivery
How and when the storefront engine evaluates carts.
- Include express checkout (Buy Now, Shop Pay) - On by default. When a customer hits Buy Now or Shop Pay, Shopify normally skips the cart page entirely. With this on, Valotrix Cart Rewards still tries to inject the gift before they leave; with it off, express orders never get gifts. Leave on unless you're seeing express orders without gifts misbehave on your specific theme.
- Double-check before checkout - Off by default. Adds a last-second verification right as your customer clicks "Check out." Most themes don't need this. Only flip on if support has specifically asked you to during a conversation.
- Factor in discounts when checking cart totals - Off by default. When on, the engine compares your threshold against the post-discount cart total instead of the original. Use it if you want a customer with a $10 promo code on a $55 cart to qualify for a $50 threshold (since they'll pay $45). Most stores leave this off so the threshold matches what the customer added.
- Response speed (evaluation delay, ms) - 300 ms by default. After your customer adds or removes an item, Valotrix Cart Rewards waits this many milliseconds before recalculating gifts. 300 ms feels instant to shoppers without burning through requests. Lower it only if your theme has unusually fast cart transitions; raise it if your storefront has many concurrent campaigns.
Cart Integrity
Three guards that catch edge cases customers can stumble into.
- Clear gifts when the cart goes empty - Picture this: a customer adds $80 of products, qualifies for a free gift, then removes everything except the gift. Without this setting, they could check out with just the freebie. This removes the gift the moment there are no paid items left.
- Stop $0 checkouts - Blocks the cart from proceeding to checkout if the only items in it are gifts (no paid product). A safety net so customers can't accidentally complete a $0 order.
- Remove $0 items you didn't create - Sometimes a customer finds a gift product in your catalog and adds it themselves, or a theme glitch duplicates a free line. This catches any $0 line that wasn't placed there by one of your campaigns and quietly removes it on the next cart update.
Preview features
Experimental settings - test thoroughly before going live. Today this card hosts one feature:
Post-Checkout Repair
A safety net for the rare case where a customer placed an order before the storefront engine could attach the gift - typically on a slow connection plus an express checkout. With this enabled, Valotrix Cart Rewards watches incoming orders and uses Shopify's Order Edit API to add the missing gift after the fact.
- Patch orders that are missing their gift - On by default. Watches incoming orders for missed gifts and repairs them.
- Practice run only (no real edits) - On by default until you've verified it works on your store. In practice-run mode, Valotrix Cart Rewards logs what it would fix without actually editing orders. Turn it off to start real repairs.
- Include dev store orders - Off by default. Whether to repair orders on dev stores during testing.
- Only repair when the live theme has the app embed on - On by default. Skip orders from themes that don't have the embed enabled (likely test orders).
- Look back how far? - 60 minutes by default. Maximum order age to consider for repair. An order placed 3 hours ago has likely been processed; we don't touch it.
Monitoring & Alerts
How Valotrix Cart Rewards tells you when something needs attention.
- Show health badges on campaigns - On by default. Adds small warning indicators next to campaigns when something's off (out-of-stock gift, deleted variant, no recent matches). At-a-glance status without opening every campaign.
- Tell me when a campaign breaks - On by default (Pro plan and above). Email when one of your campaigns references a product/variant/collection that no longer exists or has gone out of stock long-term.
- Send me a weekly recap - Off by default (Pro plan and above). Monday-morning email with the week's gift count, top-performing campaigns, and any health flags.
- Where should we send these? - Custom alert email. Leave blank to use whatever email Shopify has on file for your store.
Data & Privacy
Controls how long Valotrix Cart Rewards keeps event data and what session-level info we track.
- How long should we keep granular event data? - Choose 30 / 60 / 90 / 180 / 365 days. 90 days by default. Older events are pruned automatically. Older summary metrics stay around indefinitely.
- Clean up old events automatically - On by default. Runs the prune job nightly.
- Track cart sessions - On by default. Shopify gives every cart a random token (no personal info). We use it to follow a gift across page loads. Turn off if your privacy policy doesn't allow any session-level tracking - your analytics accuracy will drop because we can't tie events together anymore.
API & Webhooks (Scale plan)
The bottom card holds two side-by-side panels for developer integrations. Both are unlocked on the Scale plan; on lower plans the panel is visible but locked.
- API Keys. Generate, label, and revoke keys for Valotrix Cart Rewards's public REST API. Each key is shown once at creation - copy it immediately. The full developer reference (every endpoint with examples) lives in Public REST API.
- Webhook Endpoints. Point one or more URLs at Valotrix Cart Rewards and choose which events should be sent (gift added, gift removed, order with gift completed, campaign activated, etc.). Each delivery is signed so your endpoint can verify it really came from Valotrix Cart Rewards. The full developer reference is in Outbound webhooks.
Gift line display (sub-page)
A separate sub-page, reachable from the Settings screen, controls how the gift's cart row presents itself: a "Free Gift" badge, the price label ("Free" / "Included" / keep theme default / hidden), and whether the customer can change the gift's quantity. Defaults are sensible - leave them alone unless your theme renders the cart row in an unusual way.