> ## Documentation Index > Fetch the complete documentation index at: https://docs.yuko.so/llms.txt > Use this file to discover all available pages before exploring further. # Loyalty Nudges > A pinned strip on every storefront page that opens a slide-up drawer with the customer's points, rewards, VIP status and active booster campaigns. Yuko's primary on-site promotion surface. **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Loyalty Nudges ## Introduction Loyalty Nudges is a small persistent strip pinned to the top or bottom of every storefront page. When customers tap it, a slide-up drawer opens showing their points balance, VIP tier, earned rewards, ways to earn (including active **booster campaigns**) and ways to redeem — all without leaving the page they're on. It's Yuko's primary on-site promotion surface. When you launch a [Booster Campaign](/loyalty/booster-campaigns/overview), this is how customers actually see it without you having to email them. ## What problem this solves A loyalty program that lives only inside the customer account hub is invisible to the customer who's browsing products. Loyalty Nudges fixes that — the program follows the customer across every page through a single non-intrusive strip that opens a full hub when tapped. The alternative is sending an email every time you launch a campaign. Loyalty Nudges turns the storefront itself into the announcement. ## Where it appears * A small **pinned strip** on every storefront page — top or bottom of viewport, configurable. * A **slide-up drawer** that opens from the bottom when the customer taps the strip. * The drawer auto-closes after the customer applies a reward or completes an action. ## When to use * You've launched (or plan to launch) **Booster Campaigns** and want them visible on every page. * You want a persistent loyalty surface rather than only the cart or account. * You want a single on-site promotion surface that handles points, rewards, VIP and boosters together. * You operate a fast-moving storefront where customers don't browse to a dedicated `/rewards` page. ## Overview * Pinned **strip + slide-up drawer** pattern — not a modal popup, not a sidebar. * Renders on **every storefront page** automatically once enabled — no per-template setup. * Different content for **logged-in customers** vs **visitors**. * Drawer sections (Header, Your Rewards, Ways to Earn, Ways to Redeem) are individually **reorderable** by drag-and-drop and toggleable on/off. * **Booster campaigns** can be auto-surfaced (all active) or **curated** (pick specific campaigns to show). * Position (top / bottom) and visibility (desktop / mobile / both) configurable. * **Per-locale** content support. * Branded via store colours; supports custom CSS overrides. ## Before you start Yuko app is installed on your Shopify store. Your loyalty program is enabled. The widget is set to **Active** in **Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets**. Your active Shopify theme supports Online Store 2.0 app blocks. ## Setup guide ### 1. Configure in Yuko In your Shopify admin, go to **Apps → Yuko Loyalty → Loyalty → Widgets → Loyalty Nudges**. The strip is the always-visible pill that opens the drawer. Two states: * **Visitor (logged-out) text** — e.g., *“Earn points & rewards every time you shop”*. * **Member (logged-in) text** — e.g., *“Hi `{{first_name}}` — you have `{{points_balance}}` `{{points_label}}`”*. Supports placeholders so the strip personalises automatically. The top of the drawer: * **Drawer title** — e.g., *“My Loyalty Program”*. * **Greeting text** — e.g., *“Welcome back, `{{first_name}}`!”* * Toggle which member-state elements show: **points balance**, **points worth in store currency**, **VIP tier progress**. The drawer has four sections — **Header**, **Your Rewards**, **Ways to Earn**, **Ways to Redeem**. Drag to reorder them; toggle each on or off depending on what you want surfaced. Inside the **Ways to Earn** section, toggle **Show booster campaigns** on. Then choose: * **Show all active boosters** — leave the campaign selector empty. Any currently-active campaign automatically appears on the storefront. * **Curate the list** — pick specific campaigns from the multi-select. Only those appear, in your chosen order. Use the **Ways to Earn order** setting to control whether booster campaigns appear above or below your standard earning campaigns. Under the **Customization** tab: * **Position** — **top** or **bottom** of viewport. * **Display visibility** — **both** / **desktop only** / **mobile only**. * **Page exclusions** — URL fragments where the strip shouldn't render (e.g., `/blog`, checkout pages). Under the **Styles** tab: * **Primary**, **secondary**, **text** and **body description** colours. * **Custom CSS** for fine-tuned overrides (advanced). Toggle the widget **Active** and click **Save**. ### 2. Add to your storefront The Loyalty Nudges widget auto-renders on every page via the **Theme App Embed**. There's no per-template app block to add. The Yuko Theme App Embed is enabled in your **published** theme. See [Theme App Embed](/installation-and-setup/theme-app-embed) if you haven't enabled it yet. If the embed is enabled and the widget is active, the strip should appear on your storefront within a few minutes. ### 3. Verify Open your live store in a private window. The strip should render with the visitor copy and a *Create Account* CTA in the drawer. Log in as a real customer. The strip should switch to the member copy and the drawer should show their balance, tier and rewards. With at least one active booster campaign, open the drawer and confirm the Ways to Earn section surfaces it with the booster's progress UI. Apply a reward from inside the drawer. The drawer should auto-close and the strip should reflect the new state on next open. ## Available placeholders The strip and drawer header support these placeholders in their text fields: | Placeholder | Replaced with | | -------------------- | ------------------------------------------------------ | | `{{first_name}}` | Customer's first name (logged-in only). | | `{{customer_name}}` | Customer's full name (logged-in only). | | `{{points_balance}}` | Customer's current points balance (logged-in only). | | `{{points_label}}` | Your configured points label (e.g., *Stars*, *Coins*). | For logged-out visitors, the placeholders are stripped — use the dedicated visitor text fields instead. ## How it works 1. The Theme App Embed loads Loyalty Nudges on every page. 2. For visitors, the strip shows visitor copy with a join CTA. 3. For logged-in customers, the strip personalises using profile data fetched from Yuko. 4. On tap, the drawer slides up showing the configured sections. 5. Booster campaigns are fetched live (filtered by your curation setting) and rendered with type-specific UI — spending-goal progress bars, frequency milestones, streak counters, multi-action checklists. 6. Customers can apply rewards directly from the drawer; the cart updates without page navigation. ### Decision guidance * **Top vs bottom position** — bottom is the safer default (out of the way during browsing, easy to thumb on mobile). Top is louder but conflicts with sticky headers in some themes. * **Show all active boosters vs curate** — start with *show all*. Curate later if you find yourself running too many simultaneous campaigns to surface coherently. * **Boosters first vs campaigns first** — boosters first puts the time-limited urgency at the top; campaigns first keeps long-running earn rules visible above promos. Boosters-first is the more common choice. * **Page exclusions** — exclude the blog and any pages where the strip would compete with a CTA (e.g., dedicated landing pages). * **Desktop vs mobile** — leave at **both**. Mobile is where Nudges shines because most customers browse from their phone. ### Limitations * The strip is non-dismissible by the customer (closing the drawer hides the drawer but the strip stays). This is intentional — it's a persistent surface, not a popup. * Loyalty Nudges does not render at Shopify Checkout (Shopify doesn't allow custom scripts there). Use the [Checkout Earn](/onsite-widgets/checkout-earn) and [Checkout Redeem](/onsite-widgets/checkout-redeem) widgets for that surface. * For inactive customers (off-store), Loyalty Nudges can't reach them — use [email](/emails/overview) and WhatsApp instead. ## Examples * **Booster takeover during a 2X weekend** — Nudges drawer shows the Multiplier campaign with the dates and remaining time, every time a visitor lands on the site. Drives discovery without an email send. * **Spending-goal progress on every page** — the drawer shows the customer's *“$92 of $150 toward your 500-point bonus”* progress bar continuously. Most effective on-site progress visualisation Yuko has. * **First-30-days new-member nudge** — personalised strip on every page reminds new members of their first-order 2X boost. The strip text uses `{{first_name}}` so it reads as personal. * **VIP-only Diamond drawer** — Curated boosters surface only the Diamond-tier perks for top-tier customers, with the standard list for everyone else. * **Holiday hub** — During November, all themed boosters (holiday challenge, free-shipping spending goal, multi-action gift challenge) surface in one curated list to make the storefront read as *the* holiday destination. ## Best practices **Enable Loyalty Nudges before you launch your first booster campaign.** It's the cheapest, highest-leverage on-site promotion surface Yuko gives you. **Use the placeholders in the strip text.** Personalised strips (“Hi Sarah — you have 240 Stars”) outperform generic ones by a wide margin. **Curate booster visibility for VIP-only campaigns.** Don't show your top-tier perks to everyone — it dilutes the perceived exclusivity. **Exclude pages where the strip competes.** Blog post pages and dedicated landing pages are common candidates. **Test on mobile first.** Most customer interactions happen there; the drawer's bottom-sheet behaviour is built for mobile. ## FAQs Closing the drawer hides the drawer; the strip remains visible on every page. This is by design — Loyalty Nudges is a persistent surface, not a popup. The Floating Launcher is a small floating button (typically bottom-right) that opens a side panel. Loyalty Nudges is a full-width pinned strip that opens a bottom-sheet drawer. Nudges has more surface area for messaging (the strip can carry copy and placeholders); Launcher is quieter and more iconic. Most stores pick one or the other, not both. Check: (1) the booster campaign is active in **Booster Campaigns**, (2) **Show booster campaigns** is toggled on in this widget's Ways to Earn section, (3) the booster's UUID is in your curated list (or the list is empty so all boosters show), and (4) the customer falls within the campaign's targeting. The widget loads asynchronously via the Theme App Embed and fetches data only when the strip is rendered. Lighthouse impact is negligible on most themes. Yes — the configuration supports per-locale text fields. Yuko falls through customer locale → store default → English. Use the **Page exclusions** field to remove the strip from URL fragments you don't want. The widget renders by default on all other pages. ## Related Pinned strip + drawer on every page — your booster promotion surface. Show points earnable on product detail pages. Show total earnable points in cart. Surface points balance and rewards in cart. Show earnable points inside Shopify Checkout. Apply rewards inside Shopify Checkout. Confirm earned points on the thank-you page. Show points balance on the order history page. Show balance on the customer profile. Loyalty hub inside Shopify customer accounts. Standalone loyalty page for your storefront. Persistent loyalty panel on every page. Cross-widget styling, icons and language. Required to render any storefront widget. Show points and rewards inside Shopify checkout. Add the loyalty hub inside Shopify customer accounts. Confirm widgets render correctly on the live storefront. Talk to our team for personalised setup help. **Time:** 30 minutes Visit our support hub for help articles, live chat and ticket submission. Documentation across loyalty, referrals, memberships and more. Add Yuko to your Shopify store from the Shopify App Store.