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

# Activate the Customer Account Extension

> Add the Yuko Loyalty hub inside Shopify's new customer accounts.

<Note>
  **Where to find this:** Shopify admin → Settings → Customer accounts → Customize
</Note>

## Introduction

The **Customer Account Extension** adds a Yuko Loyalty hub inside Shopify's new customer accounts surface. Customers see their balance, rewards, VIP status and activity log without leaving Shopify.

## What problem this solves

Many loyalty programs send customers to a separate page to manage rewards. With this extension, the loyalty hub lives natively where customers already manage their orders and profile, dramatically improving discovery.

## Where it appears

* The new Shopify Customer Account experience.
* Both order pages (point balance) and the profile page (full loyalty hub).

## When to use

* You've enabled **New Customer Accounts** in Shopify.
* You want a loyalty hub without building a separate landing page.

## Overview

* Shopify-native extension surface.
* Adds the Yuko Loyalty hub block to customer accounts.
* Works on any paid Shopify plan with new accounts enabled.

## Before you start

<Check>Yuko is installed on your Shopify store.</Check>
<Check>**New Customer Accounts** are enabled in **Settings → Customer accounts**.</Check>

## Setup guide

<Steps>
  <Step title="Open the Customer Accounts editor">
    In your Shopify admin, go to **Settings → Customer accounts → Customize**.
  </Step>

  <Step title="Add the Yuko Loyalty block">
    Click **Add block** on the order or profile page and choose the Yuko Loyalty extension.
  </Step>

  <Step title="Position and save">
    Position the block where customers will see it and click **Save**.
  </Step>
</Steps>

<Info>
  This surface is part of Shopify's **New Customer Accounts**. Make sure new customer accounts are enabled in **Settings → Customer accounts**.
</Info>

## How it works

When a logged-in customer visits their account, Shopify mounts the Yuko Loyalty extension. It fetches the customer's points, rewards, tier and activity feed and renders them in a single hub.

### Decision guidance

* **Enable both blocks** (orders + profile) so customers see their balance everywhere they expect to.
* **Use the Rewards Landing Page** as a fallback for stores still on legacy customer accounts.

### Limitations

* Requires Shopify's New Customer Accounts. Legacy accounts are not supported.
* Visual customisation is constrained by Shopify's extension surface.

## Examples

* A growth-stage brand replaces a separate `/account/rewards` page with the embedded loyalty hub, simplifying their customer experience.

## Best practices

<Tip>**Add it on day one**. Customers expect to find loyalty inside their account; making them hunt for it costs redemption rate.</Tip>
<Tip>**Pair with a points-balance reminder email** so customers click into the new hub.</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="Can I use this with the legacy customer accounts?">
    No. Use the Rewards Landing Page widget instead.
  </Accordion>

  <Accordion title="Why don't I see the block in the editor?">
    Confirm Yuko is installed and that New Customer Accounts are enabled.
  </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>