Last verified: 2026-05-19
Customer management (admin)
View customer profiles, metrics, and order history; adjust loyalty points when a loyalty program is active.
Dashboard paths
| Area | Route |
|---|---|
| Customer list | /admin/customer |
| Customer detail | /admin/customer/[id] |
| Customer chat (related) | /admin/customer-chat |
Page title: Customer Management — Manage your customer relationships and data.
Detail page: Customer Details — View customer information and order history.
Who can do this
| Role | Access |
|---|---|
| Admin | Full for their organization(s) |
| Staff | When customer read/update permissions are granted (/staff/customer) |
Prerequisites
- Organization has processed at least some orders or sign-ups (list may be empty initially)
- For loyalty adjustments: active loyalty program and customer loyalty account
List view — metrics
Analytics cards at the top:
| Card | Description |
|---|---|
| Total Customers | Registered customer count |
| Active Customers | Active this month |
| Avg Customer Value | Average lifetime value (org currency) |
| Retention Rate | Customer retention percentage |
List view — filters
Search placeholder: Search customers by name, email, or phone...
| Filter | Options |
|---|---|
| Status | All Status, Active, Inactive |
| Type | All Types, Registered, Guest |
Table columns include customer name/avatar, contact, status badges (Active / inactive styling), type (Guest vs registered), and row actions.
Steps — view a customer
- Open
/admin/customer. - Search or filter the list.
- Click View customer details (eye icon) or open
/admin/customer/{id}. - On the detail page, use tabs:
- Overview — profile and spend summary
- Orders — order history
- Loyalty — points balance and transactions (loads when tab opened)
- Communication — messaging tools when enabled
Steps — adjust loyalty points
- From the list, click Adjust loyalty points (coins icon) on a row with a loyalty account,
or on detail → Loyalty tab → adjust action. - If no loyalty account exists, you'll see: Customer does not have a loyalty account.
- In Adjust Loyalty Points dialog:
- Action: Add Points / Deduct Points
- Number of Points (required, positive integer)
- Reason (required)
- Submit. Success toast includes new balance, e.g. Successfully added N points. New balance: X points.
Staff parity
Staff with access use /staff/customer and /staff/customer/[id] with the same patterns; permissions come from role templates.
Verify it worked
- Customer appears in search after placing an order or registering.
- Detail tabs load without errors; order tab shows historical orders.
- Loyalty adjustment updates balance on Loyalty tab after refresh.
Common issues
| Symptom | Likely cause | What to do |
|---|---|---|
| Empty list | No customers yet or wrong org scope | Confirm organization filter / admin assignment |
| Cannot adjust points | No loyalty account | Enroll customer via program/orders first |
| Guest vs Registered | Checkout without account | Expected; filter by Guest type |