> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Management

> View and track your customers from the merchant dashboard

## Customer Management

The Customers page in the merchant dashboard gives you a consolidated view of every consumer 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 backend `Customer` type:

| Field               | Description                                                 |
| ------------------- | ----------------------------------------------------------- |
| `id`                | Unique customer identifier (UUID)                           |
| `email`             | Customer email address                                      |
| `name`              | Customer name                                               |
| `country`           | Customer country                                            |
| `totalRevenue`      | Lifetime revenue from this customer (display format string) |
| `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                          |

<Note>
  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.
</Note>

***

## Customer List

The dashboard displays customers in a sortable, filterable table with these columns:

| Column        | Description                                  |
| ------------- | -------------------------------------------- |
| Email         | 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](/features/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

<Tip>
  The Customer Portal uses secure email-based authentication. Consumers authenticate via a verification link sent to their email.
</Tip>

***

## Related

<CardGroup cols={2}>
  <Card title="Customer Portal" icon="user" href="/features/customer-portal">
    Self-service portal for consumers to manage orders and subscriptions.
  </Card>

  <Card title="Orders & Payments" icon="receipt" href="/features/orders-payments">
    View and manage orders and payment records.
  </Card>
</CardGroup>