Custom Blocks
Custom Blocks is the name of the seven inline placements Valotrix Cart Rewards ships. Unlike widgets - which the app paints on top of your store pages - Custom Blocks live inside your theme: in the header section, on a product page, on collection grids, anywhere your theme allows blocks.
They render inline in your theme markup. Your designer can move them around in the theme editor without writing code.
Plan requirement
Custom Blocks are available on every plan: Free allows 1 active block, Growth $24/mo allows up to 3, Pro $49/mo allows up to 10, and Scale $99/mo is unlimited. If you need more than one Custom Block on the same store, upgrade to Growth or higher.
Available blocks
Each block declares which campaign types it serves. The block stays hidden until at least one matching campaign is live for the visitor's context - no flicker, no reserved layout space when nothing applies.
Every block ships with multiple visual templates grouped into Classic, Minimal, Premium, and Statement families - pick whichever fits your theme's voice. Switching templates is one click in the block editor and applies instantly; your color, copy, and spacing settings carry across templates.
Threshold bar - 10 templates
A progress bar block you can drop into the header, announcement bar, or PDP. Templates span from typographic restraint (Minimal, Bold, Editorial) to animated celebrations (Wave fill, Radial gauge, Step tracker) to glass-effect surfaces (Glass, Glassmorphism) to system-notification aesthetics (Notification center, Split screen).
Compatible campaign types: progress / tiered.
PDP gift preview - 10 templates
A block for product pages that shows "Buy this for a free X gift" if the current product (with quantity 1) would trigger an active campaign. Templates range from compact pills and checklists for minimalist themes (Minimal pill, Minimal checklist) to editorial layouts (Magazine, Story card, Product hero) to playful options (Polaroid) and side-by-side comparison cards.
Compatible campaign types: progress / tiered, buy-X-get-Y, variant-targeted.
PDP buy-get pairing - 10 templates
Pair a specific product with a specific gift on its PDP. "Buy this · receive this" card with optional combined add-to-cart. Templates include classic horizontal splits (Pair card, Split screen), editorial layouts (Magazine, Story card), playful pairings (Polaroid grid), and a Fullscreen-gallery dark lookbook frame for premium catalogues.
Compatible campaign types: buy-X-get-Y, variant-targeted.
Urgency banner - 10 templates
Honest scarcity + countdown. Real inventory queries, server-anchored countdown - never fakes urgency. Pairs with the threshold bar above it. Templates range from a thin Inline pill to a bottom-anchored Sticky footer to dark surfaces (Countdown urgency) to glassmorphic cards and system-notification panels.
Compatible campaign types: any active campaign.
Inline tier stack - 8 templates
Multi-tier campaign visualizer for the PDP. Shows every tier of a tiered free-gift campaign at once with a current-progress marker - combats the "I see one tier and don't realize there's better" gap. Hides automatically for single-tier campaigns (those are better served by Threshold bar). Templates include vertical timelines and card stacks, horizontal step trackers, ladder layouts, milestone markers, a nostalgic thermometer, a radial gauge, and an editorial magazine layout.
Compatible campaign types: progress / tiered with 2+ tiers.
Collection eligibility overlay - 6 templates
Stamps a small "Free gift" badge on every product card on a collection or search-results page whose product matches an active campaign. Surfaces the offer earlier in the funnel - before the shopper reaches the PDP. Templates range from tilted Corner stamps and bold Ribbons to subtle Floating pills, an Animated badge that pulses for attention, a Spotlight that blooms on card hover, and a Minimal text label for editorial themes.
Compatible campaign types: buy-X-get-Y, variant-targeted.
Gift unlock celebration - 8 templates
Brief animated banner that fires when the cart crosses a free-gift threshold. Visceral confirmation of progress; reduces post-add cart abandonment. Auto-dismisses after the configured delay (0-12 seconds). Templates include classic toast cards, inline banners, side panes, a stacked mobile-sheet drawer, glassmorphic cards, system-notification panels, and a viewport-wide flash for high-impact moments.
Compatible campaign types: progress / tiered.
Cart-row gift presentation lives in Settings, not a block
If you want gift cart rows to show "Free" instead of "$0.00" or to lock the quantity to 1, those behaviours live in Settings → Gift line display, not as a separate block. The setting applies globally to every cart with a gift line - no theme block placement required, works across cart drawers (including third-party app drawers).
How the three host blocks fit together
Valotrix Cart Rewards ships three Liquid host blocks (the wrappers your theme editor sees in the Add block menu). They all do the same job - host a Custom Block - but each is allowed in a different set of theme sections:
- Valotrix Cart Rewards Embed (
vltrx-embed) - works on every page section your theme supports. Use this when you're not sure which host to pick. - Valotrix Cart Rewards Custom Block (
vltrx-custom-block) - for page-agnostic placements (header, announcement bar, footer). - Valotrix Cart Rewards Custom Block (Line) (
vltrx-custom-block-line) - restricted to PDP and cart sections, used for blocks that read the current product or cart line context.
You don't pick which one - the theme editor only offers whichever fits the section you're editing.
How to install a block
Setup is a four-step merchant flow:
- In the Valotrix Cart Rewards admin, open Custom Blocks in the sidebar and create a new block. Pick which Custom Block (e.g. Threshold bar, PDP gift preview) and which campaign(s) it should serve.
- Copy the block ID shown on the block's detail page.
- In your Shopify theme editor (Online Store → Themes → Customize), navigate to the section where you want the block. Click Add block, choose the Valotrix Cart Rewards host block, and paste the block ID into the block's settings panel.
- Save the theme. The block goes live the next time a shopper loads the page.
Each block stays hidden on the storefront until a matching campaign is live. You'll see a "No matching live campaign" status in the admin if you've placed a block but haven't enabled a compatible campaign yet.