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

# Customer Account Page (Loyalty Hub)

> Give customers a full loyalty page inside Shopify customer accounts, with balance, VIP tiers, ways to earn and redeem, referrals and membership.

<Note>
  **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets → Loyalty Rewards: Customer Account Page
</Note>

## Introduction

The **Loyalty Rewards: Customer Account Page** widget is a full loyalty page inside Shopify customer accounts. It's the **Yuko Loyalty account page** extension, a full-page extension on the `customer-account.page.render` target, not a block you drop into an existing page.

Customers see their balance and activity, their VIP tier, ways to earn and redeem, their referral link and their membership, all on one page.

## What problem this solves

Customers expect to find their loyalty status where they manage their orders and profile. A dedicated page in the customer account removes the need to hunt for it on the storefront.

## Where it appears

* A dedicated page in Shopify customer accounts.

## When to use

* You use Shopify's customer accounts.
* You want a complete loyalty hub without building a storefront page.

## Overview

* Six sections you can drag into any order: **Header**, **VIP Tiers**, **Ways to Earn**, **Ways to Redeem**, **Referrals** and **Membership**.
* Every heading, label, button and empty state is editable.
* **Ways to earn — order** lets you show booster campaigns or standard campaigns first.
* Membership management modals (manage, update payment, cancel, upgrade, downgrade).
* VIP Tiers, Referrals and Membership sections show only when those features are active for your store.
* This widget is available on select plans.

## Before you start

<Check>Yuko is installed on your Shopify store.</Check>
<Check>The program this widget belongs to is set up and enabled.</Check>
<Check>The widget is switched on with the toggle on its card in Yuko's **Widgets** page (for loyalty widgets, **Shopify admin → Apps → Yuko Loyalty → Loyalty → Widgets**).</Check>
<Check>For storefront widgets, your active theme is an Online Store 2.0 theme that supports app embeds and app blocks.</Check>

<Check>Your store uses Shopify customer accounts (**Settings → Customer accounts**).</Check>

## Setup guide

### 1. Configure the page in Yuko

<Steps>
  <Step title="Open the widget settings">
    Go to **Loyalty → Widgets**, find **Loyalty Rewards: Customer Account Page** under **Post-Purchase**, and click **Customize**.
  </Step>

  <Step title="Order the sections">
    Drag sections by their handle to change the order they appear on the page. The default order is Header, VIP Tiers, Ways to Earn, Ways to Redeem, Referrals, Membership.
  </Step>

  <Step title="Edit each section">
    Click a section to expand it and edit its text. See [Sections and fields](#sections-and-fields) below.
  </Step>

  <Step title="Save and enable">
    Click **Save**. Back on **Loyalty → Widgets**, switch the widget's toggle on.
  </Step>
</Steps>

### 2. Make the page available in customer accounts

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

  <Step title="Open the right page">
    Use the page selector at the top to open the page where the block should appear (Order status, Orders, or Profile).
  </Step>

  <Step title="Add the Yuko app block">
    Click **Add app block** and choose the Yuko block for this widget (for example **Yuko Order status earned points**, **Yuko Order index points display** or **Yuko Profile loyalty program**).
  </Step>

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

<Info>
  Customer account blocks only work with Shopify's **new customer accounts**. Check that they're turned on in **Settings → Customer accounts**.
</Info>

The **Yuko Loyalty account page** is a full page, so instead of adding a block, link to it from your customer account menu so customers can open it. See [Customer Account Extension](/installation-and-setup/customer-account-extension) for details.

### 3. Verify

Log in as a customer and open the loyalty page from the customer account. Check each section and the order you set.

## Sections and fields

<AccordionGroup>
  <Accordion title="Header">
    The welcome card, balance, activity and VIP progress.

    * **Landing banner image**: **Default** or **Custom** (upload your own banner)
    * **Page title**: `Welcome!`
    * **Page description**: `Track your progress and unlock rewards as you earn more [points_label] ...`
    * **Available Points**: `[points_label] Balance`
    * **View activity link**: `View activity`
    * **Recent activities title**: `Recent Activities`
    * **Admin reason text when point adjustment happens**: `note: [admin_reason]`
    * **Recent activities load more text**: `Load more`
    * **Total earned card title** / **Total earned description**: `TOTAL EARNED` / `Lifetime [points_label] earned`
    * **Total redeemed card title** / **Total redeemed description**: `TOTAL REDEEMED` / `Rewards claimed and used`
    * **Current VIP tier card title**: `Current VIP tier`
    * **Next tier text**: `Next tier: [tier_name]`
    * **Points to unlock text**: `To achieve [tier_name], [remaining_points] [points_label] more.`
    * **Max tier reached text**: `You have reached the maximum tier`
  </Accordion>

  <Accordion title="VIP Tiers">
    * **Section title**: `VIP rewards & perks`
    * **Benefits section title**: `Benefits`
    * **Active badge text** / **Upcoming badge text**: `Active` / `Upcoming`
    * **No benefits text**: `No benefits`
    * **Points multiplier benefit text**: `[multiplier_value]x multiplier`
  </Accordion>

  <Accordion title="Ways to Earn">
    * **Section title**: `Ways to Earn Rewards`
    * **Ways to earn — order**: **Booster campaigns first** (default) or **Standard campaigns first**
    * **Earn points** group: **Place an order earning rule** (`Earn [points_value] [points_label] for every [currency] [amount_spent]`), and button labels **Follow**, **Share**, **Like** and **Visit**
    * **Empty state title** / **Empty state description**: `No Ways to Earn` / `Nothing here yet.`
    * **Birthday update** group: **Header prompt (shown under page description)** (`Enter your birthday to earn rewards.`), **Modal title** (`Birthday Reward`), **Birthday configure modal description**, **Day label**, **Month label**, **Year label**, **Configure button text** (`Set date`) and **Confirm button text** (`Save date`)
  </Accordion>

  <Accordion title="Ways to Redeem">
    * **Existing rewards** group: **Existing rewards section title** (`Existing rewards`), **Points spent text** (`Spent [used_points] [points_label]`), **Discount code label**, **Show more button**, **No rewards data text**, **Copy button** (`Copy code`) and **Expires on text** (`Expires on [discount_expiry_date]`)
    * **Ways to redeem** group: **Section title** (`Ways to redeem`), **Free products section title** (`Free Products`), **Earn more text** (`Earn [remaining] more [points_label]`), **Redeem button text**, **Redeem modal title** (`Redeem reward`), **Confirm redeem button text** (`Confirm Redeem`), **Show more button** and **Points to redeem label** (`[points_label] to Redeem`)
    * **Empty states** group: **No rewards empty title** (`No Rewards`), **No coupons empty title** (`No Coupons`) and **Empty state description** (`Nothing here yet.`)
  </Accordion>

  <Accordion title="Referrals">
    * **Section title**: `Referrals`
    * **Card heading**: `Refer your friends`
    * **Card description**: `Invite your friends or family to enjoy our products by sharing the link below, and we will reward you.`
    * **Referrer Reward label** / **Friend reward label**: `You get` / `They get`
    * **Get referral link button text**: `Get referral link`
    * **Copy link button text** / **Copied confirmation text**: `Copy link` / `Copied!`
  </Accordion>

  <Accordion title="Membership">
    * **Section title** (`Membership`), **Benefits title** (`Your benefits:`), **No benefits text**, **Benefits more label**, **Renews label**
    * Buttons: **Manage button**, **Update payment button**, **Cancel button**, **Upgrade button**, **Downgrade button**, **Close button**
    * **Monthly interval label** / **Yearly interval label**: `month` / `year`
    * **Manage membership modal**: **Title** (`Manage membership`)
    * **Update payment modal**: **Title**, **Description**, **Confirm button** (`Continue`), **Success text (no direct link)**, **Success text (direct link)** and **Open link button**
    * **Cancel membership confirmation**: **Title**, **Description**, **Membership subtitle**, **Dismiss button (keep membership)** (`Close`) and **Confirm button** (`Cancel membership`)
    * **Upgrade membership confirmation** and **Downgrade membership confirmation**: **Title** and **Description**
    * **Action in progress**: **In progress text** (`Your membership change is being processed. This may take a few moments.`)
    * **Activity log**: **View activity link text**, **Activity modal title** (`Membership Activity`) and **Empty state text** (`No membership activity found.`)
  </Accordion>
</AccordionGroup>

## How it works

1. A logged-in customer opens the loyalty page in their customer account.
2. The extension loads their balance, tier, rewards, ways to earn, referral link and membership from Yuko.
3. Sections render in the order you set. VIP Tiers, Referrals and Membership are skipped when those features aren't active.
4. Customers can redeem rewards, copy codes, set their birthday, get their referral link and manage their membership without leaving the page.

### Limitations

* Works only with Shopify customer accounts.
* The page's look follows Shopify's customer accounts styling; there's no custom CSS.
* You can reorder sections but not hide individual ones; VIP Tiers, Referrals and Membership hide automatically when the feature isn't active.

## Best practices

<Tip>**Put what matters most first.** If your program is VIP-led, drag **VIP Tiers** above **Ways to Earn**.</Tip>
<Tip>**Show boosters first** during promotions so time-limited campaigns get noticed.</Tip>

## FAQs

<AccordionGroup>
  <Accordion title="Can I use this with legacy customer accounts?">
    No. Use the [Rewards Landing Page](/onsite-widgets/rewards-landing-page) instead.
  </Accordion>

  <Accordion title="Why doesn't the VIP Tiers section appear?">
    The section is skipped when VIP tiers aren't active for your store. If they are, check the customer has been placed in a tier.
  </Accordion>

  <Accordion title="How is this different from the Order List and Profile widgets?">
    [Order List: Point Balance](/onsite-widgets/order-list-balance) and [Customer Profile: Point Balance](/onsite-widgets/customer-profile-balance) are small blocks on existing account pages. This widget is a full page of its own.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={3}>
  <Card title="Floating Rewards" icon="circle-arrow-up" href="/onsite-widgets/floating-launcher">
    Floating button and loyalty panel on every page.
  </Card>

  <Card title="Rewards Landing Page" icon="window-maximize" href="/onsite-widgets/rewards-landing-page">
    A dedicated loyalty page built from seven theme blocks.
  </Card>

  <Card title="Loyalty Nudges" icon="bell" href="/onsite-widgets/loyalty-nudges">
    Pinned strip and drawer on every page, ideal for boosters.
  </Card>

  <Card title="Product Page Earn" icon="bag-shopping" href="/onsite-widgets/product-page-earn">
    Show points to earn on product pages.
  </Card>

  <Card title="Cart Earn" icon="cart-plus" href="/onsite-widgets/cart-earn">
    Show points to earn on the cart.
  </Card>

  <Card title="Cart Redeem" icon="gift" href="/onsite-widgets/cart-redeem">
    Let customers redeem points and apply rewards in the cart.
  </Card>

  <Card title="Checkout Earn" icon="cash-register" href="/onsite-widgets/checkout-earn">
    Show points to earn in Shopify Checkout (Shopify Plus).
  </Card>

  <Card title="Checkout Redeem" icon="ticket" href="/onsite-widgets/checkout-redeem">
    Redeem points and apply rewards in Shopify Checkout (Shopify Plus).
  </Card>

  <Card title="Order Status Earn" icon="circle-check" href="/onsite-widgets/order-status-earn">
    Show points earned on the order status page in customer accounts.
  </Card>

  <Card title="Order List Balance" icon="receipt" href="/onsite-widgets/order-list-balance">
    Show the points balance on the Orders page in customer accounts.
  </Card>

  <Card title="Customer Profile Balance" icon="id-badge" href="/onsite-widgets/customer-profile-balance">
    Show loyalty details on the Profile page in customer accounts.
  </Card>

  <Card title="Customer Account Page" icon="user" href="/onsite-widgets/customer-account-page">
    A full loyalty page inside Shopify customer accounts.
  </Card>

  <Card title="Branding & Locale" icon="palette" href="/onsite-widgets/branding-and-locale">
    Colour palettes for all widgets, and per-language widget text.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Theme App Embed" icon="plug" href="/installation-and-setup/theme-app-embed">
    The Yuko App embed that powers Floating Rewards, Loyalty Nudges and the theme blocks.
  </Card>

  <Card title="Checkout UI Extension" icon="cart-shopping" href="/installation-and-setup/checkout-ui-extension">
    Add the earn and redeem blocks to Shopify Checkout (Shopify Plus).
  </Card>

  <Card title="Customer Account Extension" icon="user" href="/installation-and-setup/customer-account-extension">
    Add the loyalty blocks and full loyalty page to 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.