Rivo Debug / Kitchen Sink

Everything available at render time from the customer object — no JS required. This is what can be used for server-side conditionals like loyalty status gating.

Rivo populates shop.metafields.rivo.loy.points_program.points_rewards with the active rewards. If populated, rewards can be rendered server-side with zero JS — the most robust approach.

⚠️ shop.metafields.rivo.loy.points_program.points_rewards is empty or not accessible. The metafield namespace may need to be exposed in Settings → Custom data → Storefront access, or the metafield key may differ. Fall back to RivoAPI.rewards() below.

Points balance, loyalty status, lifetime earnings. The primary source of truth for what to show on the account page header.

— not yet fetched —

Current VIP tier and progress toward the next tier. Can power a progress bar showing how far the customer is from their next reward level.

— not yet fetched —

All available rewards. Compare this to the Liquid metafield above — if they match, the metafield approach works and you don't need JS for the list. Each reward also has a live Redeem button that calls RivoAPI.redeem(id).

— not yet fetched —

Rivo injects a global window.Rivo object when its embed script loads. It exposes the app proxy base URL (proxy_paths.loy) and the current customer ID — both are needed for triggering custom actions client-side without a server-side API key.

— not yet inspected —

Writes the customer's date of birth to Rivo. Rivo uses it to automatically award birthday points. The value is then readable back in Liquid as customer.metafields.custom.rivo.value.dob (if the metafield namespace is exposed). Format: MM-DD (e.g. 06-24 for June 24th — no year).

Custom actions award points for things you define in the Rivo dashboard (e.g. "Completed profile", "Added birthday"). They're triggered by POSTing to the Shopify app proxy — no server-side API key needed, authentication goes through the proxy. The proxy URL comes from window.Rivo.global_config.proxy_paths.loy.

⚠️ The custom action name must already exist in your Rivo dashboard under Ways to Earn → Custom Action — otherwise the request will return an error.

— inspect window.Rivo first to see the resolved URL —

The customer's referral URL, code, and summary stats. Useful for a "share with a friend" section on the account page.

— not yet fetched —

Timeline of points earned and spent. Powers an activity feed on the account page — shows recent transactions like "Earned 50 points for order #1234" or "Redeemed 200 points for 10% off".

— not yet fetched —

Estimates how many points the customer will earn from their current cart. Powers a "You'll earn X points with this order!" motivator on the cart page or mini-cart.

— not yet fetched —

The single most relevant reward for this customer right now. Powers a motivational "You're X points away from a free treat!" nudge bar on the account page, cart, or site-wide banner.

— not yet fetched —

Membership program status and details. Powers a digital membership card showing program enrollment, benefits, and renewal info. Fetches both endpoints to give the complete picture.

— not yet fetched —

Available loyalty gifts (different from points-based rewards). These are free gifts the customer can claim — powers a "Gifts waiting for you" section on the account page.

— not yet fetched —

QR code for in-store POS point collection. The customer shows this at checkout to earn points on physical purchases. Powers an "Earn points in store" card on the account page or a mobile-first loyalty wallet view.

— not yet fetched —

All available VIP tiers with thresholds and perks — the full program roadmap. Different from customer_tier() which only returns the customer's current tier. Powers a tier comparison table or visual progress roadmap.

— not yet fetched —

Recent orders with points earned per order. Powers a "Points earned per purchase" history view on the account page — lets the customer see exactly which orders earned them points.

— not yet fetched —

The full Shopify customer object as Rivo sees it. Useful for spotting data mismatches between Shopify and Rivo, verifying tags, and debugging customer identity issues.

— not yet fetched —

Detailed list of all referred people (vs referral_stats() which is just the summary). Powers a referral dashboard showing each person referred, their status, and points earned.

— not yet fetched —