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 → Customer Profile Balance
Introduction
Display the customer’s points balance on their profile page (typically/account/profile).
What problem this solves
Customers who navigate to their profile to update details should also see their loyalty status — it ties account management and loyalty into one mental space.Where it appears
- The customer profile page on the storefront.
When to use
- You want a balance display on the profile page without a full hub.
- You can’t or don’t want to use the Customer Account extension.
Overview
- Single-line balance display.
- Customisable message.
- Works on the storefront’s profile template.
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
2. Add to Shopify
Open the Theme Editor
In your Shopify admin, go to Online Store → Themes, find your active theme, and click Customize.
Pick the right template
Use the template selector at the top to open the page where this widget should appear (Product, Cart, etc.).
Add the Yuko app block
Click Add block in the section where you want the widget. Under Apps, select the Yuko block listed for this widget.
3. Verify
Log in and visit the profile page. The balance should render.Available placeholders
| Placeholder | Replaced with |
|---|---|
[points_value] | The numeric points value (per product, per cart or per order, depending on widget). |
[points_label] | Your configured points label (e.g., Points, Stars, Coins). |
[point_balance] | The customer’s current points balance. |
[discount_expiry_date] | The date a redeemed reward expires. |
[next_tier] | Name of the customer’s next VIP tier. |
[tier_entry_amount] | Spend or points threshold to reach the next tier. |
[multiplier_value] | Points multiplier applied at the customer’s current tier. |
How it works
- Reads the logged-in customer’s balance.
- Renders inline.
Decision guidance
- Use this if you have a custom storefront profile page. If you’re on new customer accounts, prefer the Customer Account Page widget.
Limitations
- Logged-in only.
Best practices
Related
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.
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.