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 → Online Store → Themes → Customize → App embeds

​
Introduction

The Theme App Embed is a Shopify feature that lets an app inject scripts and assets into your theme without modifying theme code. Every Yuko storefront widget — product page, cart, floating launcher, customer account — depends on this embed being enabled.

​
What problem this solves

Without an app embed, each widget would need a manual theme-code edit. The embed enables and disables Yuko’s storefront runtime in a single toggle.

​
Where it appears

  • All Yuko storefront widgets (product, cart, landing, launcher, account page).
  • The Customer Account extension still works without the embed because it’s served by Shopify, not by your theme.

​
When to use

  • Always enable the embed on your active production theme.
  • Enable it on any preview themes you’re testing widgets on.
  • Disable temporarily only if you’re troubleshooting a render issue and want to confirm Yuko is the cause.

​
Overview

  • One toggle in the Shopify Theme Editor.
  • Per-theme: enabling on one theme doesn’t enable on others.
  • Required by every theme widget; not required by Checkout or Customer Account extensions.

​
Before you start

Yuko is installed on your Shopify store.
You are working on the active or a preview Online Store 2.0 theme.

​
Setup guide

1

Open the Theme Editor

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

Open App Embeds

In the Theme Editor’s left sidebar, click the App embeds icon (looks like a puzzle piece).
3

Enable Yuko

Find Yuko in the list and toggle it On.
4

Save the theme

Click Save in the top right.

​
How it works

With the embed enabled, Shopify includes Yuko’s script tag on every page of your theme. The script:
  • Reads the active customer’s session.
  • Mounts each Yuko app block when its container is found.
  • Calls the Yuko API to fetch points, rewards and VIP status.

​
Decision guidance

  • Enable on every theme you publish — enabling it later, after launch, is a common cause of “missing widget” support tickets.
  • Don’t enable on themes you’re not actively using to keep the Theme Editor clean.

​
Limitations

  • Online Store 1.0 (vintage) themes don’t support app embeds. Either upgrade the theme or have a developer add Yuko’s snippet manually.
  • The embed is per-theme: duplicating a theme requires re-enabling the embed on the duplicate.

​
Best practices

Enable on the live theme first, then on any duplicates you’re using for QA.
Re-check after every theme update. Some merchants accidentally publish an older theme that hasn’t had the embed enabled.

​
FAQs

Yuko’s runtime is loaded asynchronously and only fetches data when a widget is on the page. Lighthouse impact is negligible on most themes.
The embed is per-theme. Make sure it’s enabled on the published theme, not just a preview.
The embed is store-wide, but each individual widget block can be added or removed per template.

​
Next steps

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.