> ## 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.

# Customers

> Manage your customer database and relationships

## Customer Management

The Customers page provides a complete view of everyone who has interacted with your products.

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/customers-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=5f3ea2b1ef174570603c9dba6c5774ba" alt="Customers List" width="1440" height="900" data-path="images/dashboard/customers-list.png" />
</Frame>

## Customer List

View all your customers in a sortable, filterable table:

| Column        | Description                                  |
| ------------- | -------------------------------------------- |
| First Seen    | When the customer first appeared             |
| Email         | Customer email address                       |
| Country       | Customer location (with flag)                |
| Status        | Current customer status                      |
| Subscriptions | Active subscription count                    |
| Payments      | Total payment count                          |
| MRR           | Monthly Recurring Revenue from this customer |
| Revenue       | Total lifetime revenue                       |

## Customer Statuses

<CardGroup cols={2}>
  <Card title="Active" icon="user-check">
    Has made payments but no active subscriptions.
  </Card>

  <Card title="Subscribed" icon="repeat">
    Has one or more active subscriptions.
  </Card>

  <Card title="Churned" icon="user-minus">
    Previously had subscriptions that are now canceled.
  </Card>

  <Card title="Inactive" icon="user-clock">
    No recent activity or purchases.
  </Card>
</CardGroup>

## Customer Details

Click on a customer row to view their full profile:

### Overview Tab

* Email and name
* Location
* Account creation date
* Total lifetime value
* Current MRR

### Subscriptions Tab

* All subscriptions (active and past)
* Subscription status
* Billing interval
* Next billing date
* Actions (pause, cancel)

### Payments Tab

* Full payment history
* Payment status
* Amounts and currencies
* Refund status
* Associated products

### Activity Tab

* Login history
* Subscription changes
* Payment events
* Support interactions

## Filtering Customers

Use filters to segment your customer base:

| Filter           | Options                               |
| ---------------- | ------------------------------------- |
| Status           | Active, Subscribed, Churned, Inactive |
| Country          | Any country                           |
| Date Range       | First seen date                       |
| Has Subscription | Yes/No                                |

### Search

Search customers by:

* Email address
* Customer name
* Customer ID

## Customer Metrics

### Statistics Cards

| Metric          | Description                     |
| --------------- | ------------------------------- |
| Total Customers | All unique customers            |
| Active          | Customers with recent activity  |
| Countries       | Number of different countries   |
| Avg. LTV        | Average customer lifetime value |

### Geography Distribution

A breakdown of your customers by country:

* Top 5 countries displayed
* Customer count per country
* Revenue per region

## Customer Actions

<AccordionGroup>
  <Accordion title="View Customer Portal">
    Generate a link to let customers manage their own subscriptions.
  </Accordion>

  <Accordion title="Create Manual Payment">
    Process a one-time charge for an existing customer.
  </Accordion>

  <Accordion title="Cancel Subscription">
    Cancel a customer's active subscription immediately or at period end.
  </Accordion>

  <Accordion title="Refund Payment">
    Issue a full or partial refund for a past payment.
  </Accordion>

  <Accordion title="Export Customer Data">
    Download customer information for GDPR compliance or analysis.
  </Accordion>
</AccordionGroup>

## Customer Portal

Waffo Pancake provides a self-service portal where customers can:

* View their active subscriptions
* Update payment methods
* Download invoices
* Cancel subscriptions
* View payment history

To give a customer access:

1. Go to customer details
2. Click "Generate Portal Link"
3. Send the secure link to the customer

<Note>
  Portal links are time-limited for security. Generate a new link if the customer needs extended access.
</Note>

## Data Export

Export your customer data in CSV format:

1. Apply any desired filters
2. Click "Export"
3. Choose fields to include
4. Download the CSV file

Available export fields:

* Email
* Name
* Country
* Status
* Created date
* Total revenue
* MRR
* Subscription count