Customer Management
The Customers page in the merchant dashboard gives you a consolidated view of every buyer who has purchased from your store. Track revenue, monitor subscriptions, and drill into individual customer details.Customer Data
Each customer record contains the following fields, sourced from the backendCustomer type:
| Field | Description |
|---|---|
id | Unique customer identifier (UUID) |
email | Customer email address |
name | Customer name |
country | Customer country |
totalRevenue | Lifetime revenue from this customer (in smallest currency units) |
mrr | Monthly Recurring Revenue attributed to this customer |
subscriptionCount | Number of subscriptions (active and past) |
paymentCount | Total number of payments |
createdAt | When the customer record was created |
updatedAt | When the customer record was last updated |
storeId | The store this customer belongs to |
The backend
Customer type does not have a status field. Any status labels shown in the dashboard UI (such as “Active” or “Subscribed”) are derived from the customer’s subscription and payment activity, not stored as a property on the customer record itself.Customer List
The dashboard displays customers in a sortable, filterable table with these columns:| Column | Description |
|---|---|
| Customer email address | |
| Country | Customer country (displayed with flag emoji) |
| Revenue | Total lifetime revenue |
| MRR | Monthly Recurring Revenue |
| Subscriptions | Subscription count |
| Payments | Payment count |
| Created | When the customer first appeared |
Search and Filtering
The customer list supports:- Text search — Search by customer email or name
- Status filtering — Filter by derived status categories based on subscription and payment activity
- Date range filtering — Filter by customer creation date
Customer Details
Click on a customer row to view their full profile.Overview
- Email and name
- Country (with flag emoji)
- Account creation date
- Total lifetime revenue
- Current MRR
- Subscription count and payment count
Subscriptions
View all subscriptions associated with this customer:- Subscription status
- Product and tier information
- Billing period
- Dates and amounts
Payments
View the full payment history for this customer:- Payment status
- Amounts and currencies
- Associated orders and products
- Refund status where applicable
Customer Portal
Customers also have access to a self-service Customer Portal where they can manage their own subscriptions and view payment history. The portal is a separate feature — see the Customer Portal page for details. Key capabilities available to customers through the portal:- View subscriptions and payments
- Change subscription tier (upgrade or downgrade)
- Cancel subscriptions
- Update billing details
- Download invoices and receipts
Related
Customer Portal
Self-service portal for buyers to manage orders and subscriptions.
Orders & Payments
View and manage orders and payment records.