> ## 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.

# Enable the Yuko Theme App Embed

> Activate Yuko's theme app embed so storefront widgets can render on your Shopify theme.

<Note>
  **Where to find this:** Shopify admin → Online Store → Themes → Customize → App embeds
</Note>

## 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

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

## Setup guide

<Steps>
  <Step title="Open the Theme Editor">
    In your Shopify admin, go to **Online Store → Themes**, find your active theme, and click **Customize**.
  </Step>

  <Step title="Open App Embeds">
    In the Theme Editor's left sidebar, click the **App embeds** icon (looks like a puzzle piece).
  </Step>

  <Step title="Enable Yuko">
    Find **Yuko** in the list and toggle it **On**.
  </Step>

  <Step title="Save the theme">
    Click **Save** in the top right.
  </Step>
</Steps>

## 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

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

## FAQs

<AccordionGroup>
  <Accordion title="Will enabling the embed affect site speed?">
    Yuko's runtime is loaded asynchronously and only fetches data when a widget is on the page. Lighthouse impact is negligible on most themes.
  </Accordion>

  <Accordion title="My widget shows up in preview but not on the live site">
    The embed is per-theme. Make sure it's enabled on the **published** theme, not just a preview.
  </Accordion>

  <Accordion title="Can I enable Yuko for only some pages?">
    The embed is store-wide, but each individual widget block can be added or removed per template.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Theme App Embed" icon="plug" href="/installation-and-setup/theme-app-embed">
    Required to render any storefront widget.
  </Card>

  <Card title="Checkout UI Extension" icon="cart-shopping" href="/installation-and-setup/checkout-ui-extension">
    Show points and rewards inside Shopify checkout.
  </Card>

  <Card title="Customer Account Extension" icon="user" href="/installation-and-setup/customer-account-extension">
    Add the loyalty hub inside Shopify customer accounts.
  </Card>

  <Card title="Verify Your Setup" icon="circle-check" href="/installation-and-setup/verify-setup">
    Confirm widgets render correctly on the live storefront.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Book a Free Setup Call" icon="phone" href="https://cal.com/rameshelamathi/yuko-demo">
    Talk to our team for personalised setup help.

    **Time:** 30 minutes
  </Card>

  <Card title="Contact Support" icon="life-ring" href="https://yuko.so/support/">
    Visit our support hub for help articles, live chat and ticket submission.
  </Card>

  <Card title="Browse the Guides" icon="book" href="/getting-started/welcome">
    Documentation across loyalty, referrals, memberships and more.
  </Card>

  <Card title="Install Yuko" icon="shop" href="https://apps.shopify.com/yuko">
    Add Yuko to your Shopify store from the Shopify App Store.
  </Card>
</CardGroup>