# Customer management

{% hint style="info" %}
This feature is available for **All** plans.
{% endhint %}

### Overview

A loyalty program is never "set and forget." Even when your earning rules, VIP tiers, and rewards are already in place, customers will still need attention - missing points, checkout as guests, lost coupons, unclear tier progress, or sync issues with Shopify and marketing tools.

These moments happen often, and when they do, the **Customer Management** page becomes the place you rely on the most. This is where you understand what happened with a specific customer and take the right action to support them.

Because of that, we focus on helping you navigate this page well. Customer Management is the hub where you handle almost everything after your loyalty program goes live - the real, ongoing work of keeping data correct and supporting your members.

{% hint style="info" %}
We constantly update this page to make sure that what you need to find, is there.
{% endhint %}

### Why we highlight this page

After setup, the loyalty program continues through your customers' real behavior: placing orders, making returns, redeeming rewards, creating coupons, referring friends, or unsubscribing from emails. Most questions or issues merchants face come from these everyday actions.

Customer Management gives you a complete view of each customer. It helps you check whether everything is properly synced, whether their points were calculated correctly, and whether referrals or rewards happened as expected. It's where you get clarity before making any changes.

### How to set up and use Customer Management

#### **Access Customer Management**

Open **Joy → Customers** from your Shopify admin sidebar.\
This brings you to the customer grid - the overview of all customers who have interacted with your loyalty program.

#### **On customer grid**

The customer grid gives you a fast, high-level understanding of your loyalty audience. Instead of opening each customer profile, you can quickly assess their current loyalty status from here. It is especially useful for support conversations, audits, or when you want to review VIP tiers or point balances at scale.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-b786b6256b8f3d0269262e6e828a61ee0d27335e%2Fimage%20(533)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

The grid displays:

* **Customer name and email** - their identity
* **Membership type** - Member, Guest, or Left
* **Points** - current active balance
* **VIP tier** - the tier they belong to
* **VIP point** - amount that contributed toward their tier, can be point amount or spent amount.
* **Birthday -** Customer birthday
* **Tier updated** - the date and time when the customer's VIP tier was last changed
* **Last updated** - the last time loyalty data was synced

You can search by name or email, filter by segments or tiers, and quickly click into any customer profile for deeper investigation.

#### **Open an individual customer profile**

Click on any customer in the grid to open their full loyalty profile.\
This is where you can review their entire journey, correct mistakes, manage points, and ensure all data is synced properly across Shopify and your integrations.

### Understanding the customer profile

#### **Overview**

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-baf3741191dc4ea64054da58f754810b65387540%2Fimage%20(534)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

This section gives you a quick snapshot of the customer so you can understand their situation before making any changes. You'll see:

* **Personal information** - Name, email, phone, birthday.
* **Membership status** - Whether they're a member or guest.
* **Shopify account details** - Account created or not, email verified or not.
* **Marketing sync** - Klaviyo and Omnisend subscription status.
* **Notification preference** - Whether they receive reward notifications.
* **VIP tier & progress** - Current tier, VIP spend, and next threshold. Also shows **Tier achieved date** (when the customer reached this tier) and **Qualifying order** (the order that triggered the tier upgrade, for Amount Spent and Number of Orders-based programs). Hover over the tier achievement date to see a tooltip with the full context: tier name, timestamp, event type, and linked order number.
* **Order summary** - Total orders and lifetime value.
* **Referral link & stats** - Their link, pending referrals, completed referrals.
* **Balance** - Active points, points earned, points redeemed, adjustments, and expirations.

These details help you quickly understand the customer's profile and diagnose most loyalty-related issues.

#### **Coupon history**

This list shows every coupon the customer has created with their points. You can review the coupon code, value, point cost, creation date, and status, and you can revoke unused coupons if needed. It's useful when checking past redemptions or repairing issues with old or lost codes.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-eb4df65652a9685b5211baeeb127cb339617bfca%2Fimage%20(544)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Referrals & referral activity**

This area displays the customer's referral link and a summary of their referral activity, including pending referrals, completed referrals, and their overall conversion rate. It gives you a quick sense of whether their referrals were tracked and credited properly.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-9e8b38996ecf364bf3e49efaabce0a9ff3142bc3%2Fimage%20(543)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Activity history (full timeline)**

This is the full timeline of the customer's loyalty activity — orders, earned points, tier upgrades, manual adjustments, redemptions, expirations, and referral events. When a customer asks "Why did I receive these points?" or "Why didn't I level up?", this timeline gives you the exact answer.

Tier upgrade entries in the timeline now show richer context: the specific order that triggered the upgrade (including an order number link), the event type (e.g., amount spent, order count), and the exact timestamp. This makes it easy to verify whether a tier change was correct and trace exactly what happened.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-f7508489d6d1ee7b5b5f54fc9371441abcf6e29f%2Fimage%20(545)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Integration sync status (Shopify, Klaviyo, Omnisend)**

This section shows whether the customer is fully synced across your connected platforms. You can open their Shopify profile directly using the Shopify view link, check whether their Shopify account exists and is email-verified, and see if the customer was successfully synced to Klaviyo or Omnisend. This helps you quickly spot issues like missing marketing profiles, unsubscribed statuses, or unverified emails - common reasons behind missing reward emails, failed flows, or identity mismatches.

#### **Notes**

The **Notes** card lets you save internal notes about a customer — for example, "VIP treatment needed," "preferred contact: email only," or "issued manual credit on 2026-03-15." Notes are **for your team only** and are never displayed to customers.

To add or edit a note, click the **Edit** (pencil) icon on the Notes card in the customer sidebar. A modal opens with a text field where you can type up to **2,000 characters**. Click **Save** to store the note.

The card displays:

* The note text (truncated at 8 lines or 300 characters, with full text visible when editing)
* A **last updated** timestamp showing when the note was most recently changed

{% hint style="info" %}
Notes are stored per customer and persist across sessions. They do not appear in customer-facing widgets, emails, or storefront.
{% endhint %}

### **Actions you can take**

#### **Adjust points**

Use this when a customer is missing points, needs a correction after a refund, or requires goodwill compensation. You can add or subtract points, choose whether the adjustment affects VIP tier progression, and leave an internal note or a customer-facing message. This is also where you can manually fix balance issues.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-f9b1b5fbede960f198f624d7c2c46bc57d9d3c03%2Fimage%20(537).png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Remember that you can add and deduct point balance
{% endhint %}

#### **Redeem rewards**

Create a reward coupon on behalf of the customer. This is helpful when the customer cannot redeem points themselves, needs a backup code after losing or misusing the original one, or when you want to generate a reward manually during support. You can select any active redeeming program, generate the coupon instantly, and confirm that the points are deducted correctly.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-50594f5e0774ce048a190c2be84ef436a6a2acc5%2Fimage%20(538)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Revoke coupons**

Cancel an unused coupon and automatically restore the customer's points. This is useful for duplicated codes, customer mistakes, or unused rewards that need to be reset.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-e8f63a049e471d603f103d2592cd1b8e5956d8b4%2Fimage%20(539)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Exclude customer from program**

Remove a customer from earning or redeeming loyalty points when needed - for example, for wholesale accounts, staff accounts, or internal testing. Once excluded, the customer will not gain new points or access rewards unless you re-enable them. See more at [other post](https://help.joy.so/customers/excluding-customers-from-loyalty-program) about this.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-b7fb2a0fe4bde28ad449e552666158676d931dda%2Fimage%20(542)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Change customer tier**

Update a customer's VIP tier when a manual correction is needed - for example, honoring a special case, fixing a miscalculated upgrade, or granting a tier as part of support. Along with changing the tier itself, you can also edit the customer's **tier points**, which directly affects their progress within that tier. This gives you full control to correct mistakes, reset progress, or align the customer's VIP status with your policies.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-f937982cfee5495374e73cc9edb1e74bb7630196%2Fimage%20(540)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Recalculate VIP tier point**

If you've manually changed a customer's tier points and want to undo that change, you can use the recalculate option. This resets the tier points based on the customer's actual order history and earning activity. It's a quick way to restore accurate progress when you change your mind or want the system to recalculate everything automatically.

<figure><img src="https://1367962225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpAxc1paAgix94BNLrez8%2Fuploads%2Fgit-blob-978d31a74b36a1a80c96efd5b7c58e86e166f28f%2Fimage%20(541)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

### In short

A loyalty program grows through what your customers do every day - earning, redeeming, referring, ordering as guests, or returning to shop again.\
**Customer Management** is where you keep all of this running smoothly. It's where you maintain accurate data, support your customers, and understand every step of their loyalty journey.
