Order List Balance Widget - Yuko Documentation

Where to find this: Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Order List: Point Balance

Introduction

The Order List: Point Balance widget shows the customer’s points balance at the top of the Orders page in their customer account. It’s the Yuko Order index points display customer account UI extension block, not a theme app block.

What problem this solves

Customers check their orders often. Showing their balance there reminds them they have points to spend on the next order.

Where it appears

The Orders page in Shopify customer accounts (customer-account.order-index.block.render), at the top of the page by default.

When to use

You use Shopify’s customer accounts.
You want a lightweight balance reminder without a full loyalty page.

Overview

Two text fields: a title and a description.
No Styles tab; the block uses Shopify customer accounts styling.
Shows only for customers with a points balance.

Before you start

Yuko is installed on your Shopify store.

The program this widget belongs to is set up and enabled.

The widget is switched on with the toggle on its card in Yuko’s Widgets page (for loyalty widgets, Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets).

For storefront widgets, your active theme is an Online Store 2.0 theme that supports app embeds and app blocks.

Your store uses Shopify customer accounts (Settings → Customer accounts).

Setup guide

Open the widget settings

Go to Loyalty → Widgets, find Order List: Point Balance under Post-Purchase, and click Customize.

Edit the text

Title: default You have [point_balance] [points_label]
Description: default Redeem your [points_label] for rewards & discounts on your next order

Save and enable

Click Save. Back on Loyalty → Widgets, switch the widget’s toggle on.

2. Add the block in the customer accounts editor

Open the Customer Accounts editor

In your Shopify admin, go to Settings → Customer accounts and click Customize.

Open the right page

Use the page selector at the top to open the page where the block should appear (Order status, Orders, or Profile).

Add the Yuko app block

Click Add app block and choose the Yuko block for this widget (for example Yuko Order status earned points, Yuko Order index points display or Yuko Profile loyalty program).

Position and save

Position the block where customers will see it and click Save.

Customer account blocks only work with Shopify’s new customer accounts. Check that they’re turned on in Settings → Customer accounts.

On the Orders page, add the Yuko Order index points display block. See Customer Account Extension for more detail.

3. Verify

Available placeholders

Placeholder	Replaced with
`[point_balance]`	Customer’s points balance.
`[points_label]`	Your loyalty points label.
`[points_cash_value]`	Cash value of the customer’s points.

How it works

A logged-in customer opens the Orders page.
The block fetches their balance from Yuko.
If they have a balance, the block shows your title and description. Customers with no points don’t see it.

Limitations

Works only with Shopify customer accounts; it isn’t a theme block.
The block’s look follows Shopify’s customer accounts styling.

FAQs

Why doesn't a customer see the block?

The block is hidden when the customer’s balance is zero. Also check that the widget toggle is on and the block is added to the Orders page.

I want a full loyalty page in the account

Use the Loyalty Rewards: Customer Account Page widget.

Full placeholder reference

Placeholders are written in square brackets, for example [points_label]. Each text field’s help text in the widget editor lists the placeholders that field supports. Available in every storefront widget text

Placeholder	Replaced with
`[points_label]`	Your points label from Loyalty → Settings (singular or plural, e.g. point / points).
`[point_balance]`	The customer’s current points balance.
`[points_cash_value]`	What the customer’s balance is worth in your store currency, based on your points-to-cash conversion rate.
`[store_name]`	Your store name.

Widget-specific placeholders

Placeholder	Replaced with	Used in
`[points_value]`	Points the customer can earn on this product, cart or order.	Product page, Cart earn, Checkout earn, Order status earn
`[first_name]`	The customer’s first name (logged-in customers only).	Cart redeem greeting, Loyalty Nudges
`[customer_name]`	The customer’s full name (logged-in customers only).	Loyalty Nudges
`[points_needed]`	How many more points the customer needs for a reward.	Insufficient-points text (Cart redeem, Loyalty Nudges)
`[expiration_date]`	The expiry date of an earned reward. Hidden automatically when the reward doesn’t expire. `[discount_expiry_date]` works the same way.	Reward expiry text (Cart redeem, Loyalty Nudges, Floating Rewards)
`[points_to_redeem]`	The number of points the customer chose to redeem.	Checkout redeem summary
`[discount_value]`	The discount those points unlock.	Checkout redeem summary
`[tier_name]`	A VIP tier name.	VIP tier text (Floating Rewards)
`[next_tier]`	The name of the customer’s next VIP tier.	VIP progress text
`[tier_entry_amount]`	The threshold needed to enter a tier.	Cart redeem tier entry text
`[tier_reach_level]`	The threshold needed to reach a tier.	Floating Rewards VIP text
`[multiplier_value]`	The points multiplier for a VIP tier (e.g. 2). Shown only when the multiplier is greater than 1.	Points multiplier benefit text
`[renewal_date]`	The date a paid membership renews.	Floating Rewards membership text

Floating Rewards

Floating button and loyalty panel on every page.

Rewards Landing Page

A dedicated loyalty page built from seven theme blocks.

Loyalty Nudges

Pinned strip and drawer on every page, ideal for boosters.

Product Page Earn

Show points to earn on product pages.

Cart Earn

Show points to earn on the cart.

Cart Redeem

Let customers redeem points and apply rewards in the cart.

Checkout Earn

Show points to earn in Shopify Checkout (Shopify Plus).

Checkout Redeem

Redeem points and apply rewards in Shopify Checkout (Shopify Plus).

Order Status Earn

Show points earned on the order status page in customer accounts.