Skip to main content
Where to find this: Shopify admin → Online Store → Themes → Customize → App embeds → Yuko App

​
Introduction

Yuko adds one app embed to your theme, called Yuko App. It loads Yuko’s storefront script and styles on every page of your online store. The floating and pinned widgets render directly through it, and every Yuko theme block gets its content from it.

​
What problem this solves

You don’t need to edit theme code. One toggle in the Theme Editor turns Yuko’s storefront runtime on or off.

​
What depends on the embed

​
When to use

  • Always enable the embed on your published theme.
  • Enable it on any unpublished theme you’re using to preview or test widgets.

​
Before you start

Yuko is installed on your Shopify store.
You know which theme is published, plus any theme you’re preparing to publish.

​
Setup guide

1

Open the Theme Editor

In your Shopify admin, go to Online Store → Themes, find your theme, and click Customize.
2

Open App embeds

In the Theme Editor’s left sidebar, click the App embeds icon.
3

Turn on Yuko App

Find Yuko App in the list and switch it on.
4

Save the theme

Click Save in the top right.
You can also start from inside Yuko. On the Dashboard, the Setup Guide item Enable Yuko Theme App Extension has an Activate button that opens the Theme Editor’s App embeds with Yuko App switched on, ready for you to save. Click Refresh status once you’ve saved. The Cart Earn and Cart Redeem widget pages show an Enable Theme Extension button while the embed is off.

​
How it works

With the embed on, Shopify adds Yuko’s script and stylesheet to every storefront page. The script:
  • Reads your widget settings from Yuko and the logged-in customer from Shopify.
  • Renders Floating Rewards and Loyalty Nudges if they’re enabled in Loyalty → Widgets.
  • Fills every Yuko theme block it finds on the page.
  • Inserts the cart messages into the cart automatically, using your theme’s cart area or the Custom placement selector you set on the widget.
A widget appears only when it’s also switched on in Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets.

​
Limitations

  • The embed is per theme. Turning it on for one theme doesn’t turn it on for your other themes.
  • App embeds work on any theme, but theme blocks (product, cart and landing page) need an Online Store 2.0 theme that supports app blocks.

​
Best practices

Check the embed whenever you publish a new theme. A newly published theme that never had the embed turned on is the most common cause of missing widgets.
Turn it on before you add blocks. Blocks added without the embed show up in the editor but stay empty on the storefront.

​
FAQs

The embed is per theme. Make sure Yuko App is on in the published theme, not just the one you previewed.
The embed itself loads on every page. Control where widgets appear from each widget: add theme blocks only to the templates you want, and use the visibility settings on Floating Rewards and Loyalty Nudges.
No. Those are Shopify extensions that you add in the Checkout and Customer Accounts editors.

​
Next steps

Theme App Embed

The Yuko App embed that powers Floating Rewards, Loyalty Nudges and the theme blocks.

Checkout UI Extension

Add the earn and redeem blocks to Shopify Checkout (Shopify Plus).

Customer Account Extension

Add the loyalty blocks and full loyalty page to 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.