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

# Customer profiles

> Search customers, inspect drop history and engagement metrics, add profiles manually, and archive records you no longer need.

**Customers** gives you a complete view of everyone who has signed in for your drops, been added manually by your team, or synced from a Klaviyo or Mailchimp list. Open any profile to check lifetime spend, engagement, audience membership, invite delivery, and every queue, draw, auction, waitlist, or appointment they've entered—helpful for answering support questions or checking why someone did or didn't get in.

**Customers** is available on every plan, and any team member can add or archive profiles. The **Loyalty** column appears on every plan, though earning and adjusting points requires the Pro plan or above (see [Run a loyalty program](https://docs.fanfare.io/guide/learn/loyalty.md)).

> [!NOTE]
>
> Guest entrants and archived customers don't appear in the **Customers** list. A guest who placed an order has a minimal profile reachable only from their name on that order. See [Customers and identity](https://docs.fanfare.io/concepts/customers.md).

## Browse and search customers

Open **Customers** in the sidebar to view your directory (10 customers per page).

| Column | What it shows |
| - | - |
| **Customer** | Name (or email/phone if unnamed), with email and phone underneath and a verified checkmark once confirmed via sign-in code. |
| **Value** | Lifetime value in your currency, with order count and average order value underneath. |
| **Engagement** | **High** (top third), **Medium** (middle third), or **Low** (bottom third) compared with your other customers, plus total interactions underneath. |
| **Loyalty** | Spendable points balance with lifetime points underneath (or "—" if they have no points). |
| **Activity** | Time since their last order and recency status: **Fresh** (under 7 days), **Active** (under 30 days), **At risk** (up to 60 days), or **Dormant** (over 60 days). |

* **Search:** Type at least two characters to match whole words in a customer's name or any part of their email address (phone numbers aren't searched).
* **Sort:** Select **Value** or **Activity** and choose **Asc** or **Desc**.

Select any row to open that customer's profile.

## Add a customer

Add VIPs or early-access members ahead of a drop so they're ready for audience gating and invites.

**1. Open the form**

In **Customers**, select **Add Customer**.

**2. Enter customer details**

Fill in **Email Address** (required) and any optional fields below.

**3. Create the profile**

Select **Create Customer**. Rule-based audiences re-evaluate the new profile immediately, so the customer joins any audience whose rules they match.

![The Add New Customer form with fields for email address, full name, phone number, status, and lifetime points, and Cancel and Create Customer buttons. The lifetime points field is highlighted.](https://mintcdn.com/fanfare/moPyXPoB2hbFUSf7/images/guide/guide-learn-customers-add.webp?fit=max\&auto=format\&n=moPyXPoB2hbFUSf7\&q=85\&s=dd4baa46ee1f3db75c5b067a18444c57)

Add a customer manually before a drop; double-check all fields before saving since profiles can't be edited afterward.

| Field | What it sets | Default | Editable later? |
| - | - | - | - |
| **Email Address** | Unique customer email within your organization. | Required | No |
| **Full Name** | Display name on the list and profile. | Blank | No |
| **Phone Number** | Unique phone number; numbers without a country code default to your organization's country. | Blank | No |
| **Status** | Displays an **Active** or **Inactive** badge on the profile (doesn't prevent signing in or entering drops). | **Active** | No |
| **Lifetime points** | Starting lifetime points total. | 0 | Indirectly—rises as the customer earns points or when you add points via **Adjust points** (requires the loyalty program). |

> [!NOTE]
>
> **Lifetime points** sets lifetime points only—it doesn't grant a spendable balance or create a Points Ledger entry. Loyalty tiers based on lifetime points count it, while loyalty priority in queues and draws (which uses spendable balance) doesn't.

Customer profiles can't be edited in the admin after creation, so verify details before selecting **Create Customer**. Manually added emails and phone numbers appear without a verified checkmark until the customer signs in with a verification code.

## Read a customer's profile

Open a profile from **Customers** or by selecting a customer's name on an order (see [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md)).

The header displays the customer's name, **Active** or **Inactive** badge, contact details (with a verified checkmark once confirmed via sign-in code), and an **Archive** button (hidden for customers synced from Klaviyo or Mailchimp, including manually added profiles that later match a synced list).

### Metric cards

Four summary cards break down a customer's history (test orders are excluded). Percentile bars labeled **"Top N%"** or **"Bottom N%"** compare the customer against the rest of your customer base and show "—" until there's enough activity to score.

| Card | What it shows |
| - | - |
| **Value** | **Lifetime value** headline, **Lifetime value** and **Monetary** percentile bars, **Average order value**, **Orders**, and **Loyalty points** (balance · lifetime). |
| **Purchasing** | Last order date and recency label, **Frequency** and **Activity** percentile bars, **Orders every** (\~N days once they have multiple orders), and **Returns** (`N of M`). |
| **Engagement** | **Response rate** (share of messages opened, clicked, or read), **Last engaged**, **Location** (last known city/region or country plus time zone), and **Best send time**. |
| **Risk** | **Churn risk**, **Return rate**, and **Bot risk** (**Low**, **Medium**, or **High**). |

**Best send time** suggests 8 AM, 12 PM, 3 PM, or 7 PM based on when the customer last engaged—in the customer's own time zone, not yours.

When your loyalty program is active, the **Value** card includes **Adjust points** and a **Points Ledger** appears beside the drops timeline. See [Run a loyalty program](https://docs.fanfare.io/guide/learn/loyalty.md).

### Invites

When an audience-gated sequence has an invite for this customer, the **Invites** card tracks each one through five stages: **In audience** → **Invited** → **Delivered** → **Clicked** → **Entered** (failed steps, such as a bounced email, highlight in red with the reason).

You can trigger an individual email from the card when needed:

* **Send invite now** — Sends the invite to a customer who is in the audience and hasn't been invited yet. The button also appears for customers skipped for having no email address, but the send fails until they have one, and you can't add an email to an existing customer in the admin.
* **Resend invite** — Re-sends an invite that was already sent (including invites that bounced).

Send actions are unavailable if the customer left the audience, opted out of marketing email, or if the sequence's invite is turned off. Sends are rate-limited if triggered repeatedly in a short window. See [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md) to configure invites.

### Audiences

The **Audiences** card lists every audience the customer belongs to and links directly to each one. Rule-based audiences note **"As of its build"**—membership reflects the audience's last build or last re-check of this customer. See [Audiences and access codes](https://docs.fanfare.io/concepts/audiences.md) and [Build audiences](https://docs.fanfare.io/guide/create/audiences.md).

### Drops

The **Drops** timeline lists every experience the customer participated in, newest first (10 per page—select **Show N more** for older history). Each row shows the distribution type, sequence, outcome badge, and date. Expand a row to see:

* Step-by-step entry progress (such as **Joined line**, **Admitted**, and **Completed**)
* Auction bids
* Messages sent for that experience
* **Open sequence** to jump straight to that sequence
* **Orders for this experience** (when any entry converted)—opens *all* orders for that experience, not just this customer's

Below the experiences list, **Other messages** and **Sign-in and account messages** group remaining notifications and sign-in codes. Timed releases and standalone orders don't appear in the **Drops** timeline.

| Distribution | Outcome badges |
| - | - |
| **Queue** | Completed; Admitted; In line; Left the line; Not in line; Admitted, time ran out; Sold out; Queue closed; Order limit reached; Not admitted; Not completed |
| **Draw** | Completed; Won; Entered; Withdrew; Not entered; Not selected; Won, time ran out; Sold out; Draw closed; Order limit reached; Entry refused; Not completed |
| **Auction** | Won; Lost; Winning; Bidding; Outbid; Watching |
| **Waitlist** | Converted; On waitlist; Notified; Expired; Left the waitlist; Not joined |
| **Appointment** | Completed; Booked; Checked in; No-show; Cancelled; Not booked |

To see how these stages appear on the storefront, read [What your customers see](https://docs.fanfare.io/guide/drop/what-customers-see.md).

## Archive a customer

Archiving removes a customer from your directory. Customers synced from Klaviyo or Mailchimp can't be archived.

> [!WARNING]
>
> Archiving can't be undone—an archived customer can't be restored, and their email address and phone number stay permanently reserved so you can't create a new profile with either one. Archiving doesn't stop that person from signing in to future drops.

**1. Open the profile**

Open the customer's profile from **Customers**.

**2. Confirm archiving**

Select **Archive**, then confirm **Archive** in the dialog.

## On Shopify

The **Customers** directory, profiles, and **Add Customer** form work the same in the Fanfare Shopify app. Fanfare doesn't import your Shopify customer list—customers appear here only after signing in to a drop or being added manually, and you can archive them unless they're synced from Klaviyo or Mailchimp. See [Integrations](https://docs.fanfare.io/guide/account/integrations.md) for list sync details.

## Troubleshooting

> [accordion] Search isn't filtering or can't find a customer
>
> Search requires at least two characters. Names match only on whole words, and phone numbers aren't searched—try the customer's full first or last name, or part of their email address.

> [accordion] There's no Archive button on a profile
>
> The customer is synced from a Klaviyo or Mailchimp list (either originally or after appearing on a synced list). Synced customers can't be archived in Fanfare.

> [accordion] Creating a customer shows 'Failed to create customer'
>
> When you see "Failed to create customer", another profile—including an archived customer—already uses that email address or phone number. Search active profiles for the email; archived emails and phone numbers can't be reused.

> [accordion] The Drops timeline is completely blank
>
> A customer with no drop entries shows **"No drops yet"**. If the section is blank instead, reload the page to retry loading their activity.

## Related

> [card] [Customers and identity](https://docs.fanfare.io/concepts/customers.md)
>
> Understand guests vs. signed-in customers and how profiles are created.

> [card] [Run a loyalty program](https://docs.fanfare.io/guide/learn/loyalty.md)
>
> Adjust point balances, inspect the points ledger, and configure expiration.

> [card] [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md)
>
> Review a customer's orders and process refunds.

> [card] [Invites, waitlist and access-code sends](https://docs.fanfare.io/guide/create/invites-and-waitlist.md)
>
> Configure the audience invites tracked on customer profiles.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.