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 → Apps → Yuko Loyalty → Memberships → Contracts

​
Introduction

A Contract is the link between a customer and a membership plan. Each active contract represents one customer’s subscription to one plan, with its own start date, renewal schedule and status.

​
What problem this solves

You need a single view of who’s subscribed to what — and the ability to act on individual contracts (cancel, pause, switch plan).

​
When to use

  • Resolving customer support tickets about their membership.
  • Auditing active members per plan.
  • Handling cancellations and pauses.

​
Overview

  • List view of all contracts.
  • Detail view per contract — customer, plan, start date, next renewal, status.
  • Cancel or pause individual contracts.
  • Activity log per contract.

​
Before you start

Yuko app is installed on your Shopify store — see Install Yuko on Shopify.
The Yuko Theme App Embed is enabled in your active theme.
Your loyalty program is enabled at Shopify admin → Apps → Yuko Loyalty → Loyalty → Settings.
Points label and currency are configured.
At least one membership plan is published.

​
Setup guide

​
Find a contract

1

Open Contracts

Go to Apps → Yuko Loyalty → Memberships → Contracts.
2

Search

Search by customer email or plan name. Filter by status (active, paused, cancelled).
3

Open the contract

Click a row to open the contract detail.

​
View activity

The contract detail shows:
  • Customer details and Shopify customer link.
  • Plan name and pricing.
  • Start date and next renewal date.
  • Status history.
  • All renewal events and status changes.

​
Cancel or pause

1

Open the contract

Find and open the contract.
2

Click Cancel or Pause

  • Cancel — stops future renewals. Existing perks remain until the period ends.
  • Pause — temporary stop. Resume manually.
3

Confirm and add a note

Add a reason note for the audit log.

​
How it works

  • A contract is created when a customer pays for a plan.
  • Yuko tracks renewal events from Shopify.
  • Cancellation stops future renewals; member benefits remain until the period ends.
  • Refunds are handled in Shopify; the contract status updates accordingly.

​
Decision guidance

  • Use Pause for short-term breaks (e.g., the customer is travelling).
  • Use Cancel for permanent leaves.
  • Always add a note — future support agents will thank you.

​
Limitations

  • Renewal handling depends on Shopify’s recurring billing capabilities.
  • Cancellation does not automatically refund — issue refunds in Shopify if needed.
  • One contract per customer per plan — a customer can’t have two active contracts on the same plan.

​
Examples

  • A customer pauses their VIP membership for two months while travelling, then resumes.
  • A support agent cancels a contract and refunds the latest charge in Shopify.

​
Best practices

Always add a reason note when cancelling or pausing. The audit log is your source of truth.
Surface contract status in your support tooling by tagging Shopify customers via Yuko’s tagging integration.

​
FAQs

Benefits remain active until the end of the current paid period, then end automatically.
Yes — they purchase the plan again, which creates a new contract.
Refund the underlying Shopify order. Yuko reflects the change automatically.

Membership Plans

Create paid plans with custom benefits and pricing.

Contracts

Manage active member subscriptions.

Membership Widgets

Surface plans and member status across the storefront.

Checkout Validation

Validate active membership at Shopify Checkout.

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.