Skip to main content
Where to find this: Shopify admin → Apps → Yuko Loyalty → Dashboard

​
Introduction

Run through this checklist after installing Yuko, and again after any big change such as publishing a new theme or switching to new customer accounts. Each check takes a moment and catches the most common reasons a widget doesn’t show.

​
What problem this solves

Most “widget not showing” problems come from one of three things: the Yuko App embed is off on the published theme, the widget is switched off in Yuko, or the block was never added in the Shopify editor. This checklist covers all three.

​
When to use

  • Right after installation.
  • After publishing a new theme.
  • After turning on new customer accounts or adding checkout blocks.
  • Before launching a big loyalty campaign.

​
Verification checklist

1

Confirm the loyalty program is enabled

Open Apps → Yuko Loyalty → Loyalty → Programs and check that Loyalty Program Status shows the program as enabled.
2

Confirm the Yuko App embed is on

On the Dashboard, the Setup Guide item Enable Yuko Theme App Extension should be complete. Click Refresh status if you’ve just turned it on. You can also check in the Theme Editor of your published theme under App embeds → Yuko App. See Theme App Embed.
3

Confirm you have an active earn rule and reward

In Loyalty → Programs, make sure at least one way to earn (for example Place an order) and one way to redeem are active.
4

Confirm your widgets are switched on

Open Loyalty → Widgets and check that each widget you want is switched on.
5

Confirm the blocks are placed

Theme blocks (product, cart, landing page) go in the Theme Editor. Checkout blocks go in the Checkout Editor. Customer account blocks go in the Customer Accounts editor. See Checkout UI Extension and Customer Account Extension.
6

Test on the live storefront

Open your store in a private window. Check that Floating Rewards appears, then log in as a test customer and add a product to the cart to see the cart messages.
7

Place a test order

Complete a low-value order as the test customer. Once it reaches the Earning Status set in Loyalty → Settings (Paid, Fulfilled or Delivered), open the customer in Customers and check that the points were added.

​
Common issues

  1. Check that Yuko App is on in the published theme, not only a preview theme.
  2. Check that the widget is switched on in Loyalty → Widgets.
  3. For theme blocks, check that the block was added to that template in the Theme Editor.
  4. For Floating Rewards and Loyalty Nudges, check their visibility settings (device and page rules).
  5. Hard-refresh the page.
  1. Has the order reached the Earning Status set in Loyalty → Settings? Points aren’t added before then.
  2. Does the Place an order rule have a holding period? Points are held until it ends.
  3. Is the customer excluded, for example by a customer tag excluded in Loyalty → Settings or in the earn rule?
  4. Open the customer in Customers to see their activity.
  1. Checkout blocks need Shopify Plus.
  2. Check that the block was added in the Checkout Editor and saved.
  3. Check that Checkout: Earn points or Checkout: Redeem points is switched on in Loyalty → Widgets.
  1. Check that new customer accounts are turned on in Shopify.
  2. Check that the Yuko block was added in the Customer Accounts editor, or that the Yuko Loyalty account page is linked from your customer account menu.
  3. Sign out and back in to refresh the session.

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.