Skip to main content

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.

Where to find this: Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Floating Launcher

​
Introduction

The Floating Launcher is a persistent button (typically in the bottom-right) on every page of your storefront. Clicking it opens a side panel with the customer’s balance, rewards and VIP status.

​
What problem this solves

Customers shouldn’t have to navigate to a specific page to interact with their loyalty status. A persistent launcher means it’s always one tap away — the most discoverable surface in the program.

​
Where it appears

  • Every storefront page (auto-rendered via the Theme App Embed).
  • Position is configurable (bottom-right by default).

​
When to use

  • You want maximum loyalty discoverability.
  • You don’t want to manage individual widget placements per template.
  • You’re optimising for mobile, where a floating button beats inline widgets.

​
Overview

  • Auto-renders via the Theme App Embed — no per-template setup.
  • Configurable button shape, color, position.
  • Opens a panel with balance, rewards, VIP, activity.
  • Optional notification dot when the customer has unspent rewards.

​
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

Open the widget settings

Go to Apps → Yuko Loyalty → Loyalty → Widgets → Floating Launcher.
2

Customise the launcher button

  • Shape: round / square / pill.
  • Position: bottom-right (default), bottom-left.
  • Icon and label.
3

Configure the side panel content

Toggle which sections appear in the panel:
  • Balance
  • Earned rewards
  • Ways to redeem
  • VIP status
  • Activity feed
4

Configure the notification dot

Show a small badge when the customer has unspent rewards.
5

Activate

Toggle Active. The launcher renders on every page automatically (via the Theme App Embed).

​
How it works

  • The Theme App Embed includes the launcher script on every page.
  • The launcher button mounts in the configured corner.
  • Clicking opens a panel that pulls live data from Yuko.

​
Decision guidance

  • Use the launcher as your primary discoverability surface — it’s the easiest way for customers to find their loyalty info.
  • Match the button color to your brand — too contrast-heavy and it competes with your CTAs.

​
Limitations

  • Position is corner-based; mid-page anchoring isn’t supported.
  • May overlap with chat widgets (Intercom, Tidio, etc.). Stagger positions to avoid this.
  • The Theme App Embed must be enabled — see Theme App Embed.

​
Examples

  • A round green launcher in the bottom-right with a star icon, opening a panel with balance + rewards + VIP.

​
Best practices

Don’t double up. If you use the Floating Launcher, you usually don’t need the Cart Redeem widget on the cart drawer.
Stagger from chat widgets. If you have Intercom, push the loyalty launcher up or use the opposite corner.
Show the notification dot. It’s the single biggest driver of redemption rate via this surface.

​
FAQs

Yes — add page exclusions in the launcher configuration.
Move the launcher to the opposite corner or adjust its vertical offset.
No — Shopify Checkout doesn’t allow custom scripts. Use the Checkout Earn and Checkout Redeem widgets instead.

Product Page Earn

Show points earnable on product detail pages.

Cart Earn

Show total earnable points in cart.

Cart Redeem

Surface points balance and rewards in cart.

Checkout Earn

Show earnable points inside Shopify Checkout.

Checkout Redeem

Apply rewards inside Shopify Checkout.

Order Status Earn

Confirm earned points on the thank-you page.

Order List Balance

Show points balance on the order history page.

Customer Profile Balance

Show balance on the customer profile.

Customer Account Page

Loyalty hub inside Shopify customer accounts.

Rewards Landing Page

Standalone loyalty page for your storefront.

Floating Launcher

Persistent loyalty panel on every page.

Branding & Locale

Cross-widget styling, icons and language.

Theme App Embed

Required to render any storefront widget.

Checkout UI Extension

Show points and rewards inside Shopify checkout.

Customer Account Extension

Add the loyalty hub inside Shopify customer accounts.

Verify Your Setup

Confirm widgets render correctly on the live storefront.

Book a Free Setup Call

Talk to our team for personalised setup help.Time: 30 minutes

Contact Support

Visit our support hub for help articles, live chat and ticket submission.

Browse the Guides

Documentation across loyalty, referrals, memberships and more.

Install Yuko

Add Yuko to your Shopify store from the Shopify App Store.