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

# Quickstart (Shopify)

> Install Yuko, review the program it sets up for you, turn on the storefront widgets and test your first earned points.

<Note>
  **Where to find this:** Shopify admin → Apps → Yuko Loyalty → Dashboard
</Note>

This quickstart takes you from a fresh install to a live loyalty program. Yuko sets up a working program for you on install, so most of the work is reviewing it and switching on the widgets. By the end you'll have:

* Yuko installed, with points worth **100 points = \$1** (in your store currency).
* Default Ways to Earn, rewards, VIP tiers and a referral program you've reviewed.
* Floating Rewards and the cart widgets showing on your storefront.
* A test customer with points from a real order.

<Info>
  If you'd rather have someone walk you through this live, [book a free 30-minute setup call](https://cal.com/rameshelamathi/yuko-demo).
</Info>

## Before you start

<Check>You have admin access to your Shopify store.</Check>
<Check>Your active theme is an Online Store 2.0 theme. See [Theme compatibility](/getting-started/theme-compatibility).</Check>

## Step 1: Install Yuko and enter your contact details

<Steps>
  <Step title="Install from the Shopify App Store">
    Visit [apps.shopify.com/yuko](https://apps.shopify.com/yuko), click **Install** and approve the permissions Yuko requests.
  </Step>

  <Step title="Set up your loyalty rewards">
    Yuko opens a **Set up your loyalty rewards** screen. Enter your **Contact email** and, optionally, a **Phone number**, then click **Get Started**.
  </Step>
</Steps>

That's all the onboarding asks for. Yuko sets your points value to **100 points = \$1** and creates a starter program for you. Full details: [Install Yuko on Shopify](/installation-and-setup/install-on-shopify).

## Step 2: Review what Yuko set up for you

Yuko creates this starter program on install. Review it and change anything that doesn't fit your store.

| Area | What's created |
| - | - |
| **Ways to Earn** | **Place an order** (1 point per \$1 spent), **Sign Up** (100 points) and **Birthday** (500 points) are on. **Instagram Follow** and **Facebook Like** (100 points each) are created but off. |
| **Ways to Redeem** | Three amount discounts: 500 points for $5 off, 1,000 points for $10 off and 2,000 points for \$20 off. |
| **VIP Tiers** | **Bronze** (default, 0 points, 1x), **Silver** (1,000 points, 2x) and **Gold** (5,000 points, 3x). |
| **Referral program** | $10 off for the referrer and $10 off for the friend. |
| **Floating Rewards** | The floating rewards widget is turned on. |
| **Branding** | The **Eclipse Black** colour palette. |

<Steps>
  <Step title="Open Loyalty">
    In your Shopify admin, go to **Apps → Yuko Loyalty → Loyalty**. Check that **Loyalty Program Status** is enabled.
  </Step>

  <Step title="Review Ways to earn and Ways to redeem">
    On the **Programs** tab, open each Way to Earn and reward to adjust points, values and limits. See [Ways to Earn](/loyalty/ways-to-earn/overview) and [Ways to Redeem](/loyalty/ways-to-redeem/overview).
  </Step>

  <Step title="Check your settings">
    On the **Settings** tab, review your **Point Label**, the **Points to Cash Conversion Rate** and when points are earned. See [Program Settings](/loyalty/program-settings).
  </Step>

  <Step title="Review VIP and Referral (optional)">
    Open **VIP** and **Referral** in the sidebar to review or turn on those programs. See [VIP Tiers](/vip-tiers/overview) and [Referrals](/referrals/overview).
  </Step>
</Steps>

The **Set up your programs** checklist on the [Dashboard](/analytics/dashboard) shows which programs are on.

## Step 3: Turn on the storefront widgets

<Steps>
  <Step title="Enable the Yuko App embed">
    On the Dashboard, under **Setup Guide**, click **Activate**. In the Theme Editor, switch on **Yuko App** under **App embeds** and click **Save**. Then click **Refresh status** in Yuko. See [Enable the Yuko App Embed](/installation-and-setup/theme-app-embed).
  </Step>

  <Step title="Check Floating Rewards">
    Open your storefront. The Floating Rewards button appears because it's on by default. Customise it under **Loyalty → Widgets**. See [Floating Rewards](/onsite-widgets/floating-launcher).
  </Step>

  <Step title="Add the cart widgets (optional)">
    Turn on [Cart Earn](/onsite-widgets/cart-earn) and [Cart Redeem](/onsite-widgets/cart-redeem) under **Loyalty → Widgets** so customers see points and rewards in the cart.
  </Step>
</Steps>

## Step 4: Test with a real order

<Steps>
  <Step title="Place a test order">
    Log in to a customer account on your storefront and place a small real order.
  </Step>

  <Step title="Wait for the points">
    Points are credited when the order reaches the status set in **Earning Status** (**Loyalty → Settings**), after any **Holding period** you've set on the **Place an order** rule.
  </Step>

  <Step title="Check in Yuko">
    Go to **Customers** in the Yuko sidebar, click the test customer and check the points balance and activity.
  </Step>
</Steps>

## What to do next

<CardGroup cols={2}>
  <Card title="Add more Ways to Earn" icon="hand-holding-dollar" href="/loyalty/ways-to-earn/overview">
    Reward reviews, social follows, newsletter sign-ups and more.
  </Card>

  <Card title="Set up VIP Tiers" icon="crown" href="/vip-tiers/overview">
    Reward your top customers with multipliers and tier benefits.
  </Card>

  <Card title="Launch Referrals" icon="share-nodes" href="/referrals/overview">
    Give customers a way to refer friends and earn.
  </Card>

  <Card title="Customise emails" icon="envelope" href="/emails/overview">
    Edit the emails customers receive when they earn, redeem or unlock a tier.
  </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.