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

# Fan Database

> Build and manage your artist's direct-to-fan relationship.

The **Fan Database** is your artist's CRM — a central place where every fan interaction is tracked and stored. Every purchase, sign-up, event attendance, and engagement builds a richer profile over time.

## Viewing your fans

Navigate to **Fans** from the dashboard sidebar. You'll see a searchable, filterable table of all fans in your database.

### Fan profile

Each fan profile includes:

| Data point           | Description                                   |
| -------------------- | --------------------------------------------- |
| **Name**             | Fan's full name                               |
| **Phone**            | Phone number (primary identifier)             |
| **Email**            | Email address                                 |
| **Location**         | City, state, country (enriched automatically) |
| **Fanpass status**   | Whether they have an active Fanpass           |
| **Purchase history** | All transactions tied to this fan             |
| **Events attended**  | Shows where they made purchases or checked in |
| **Rewards**          | Earned and claimed rewards                    |
| **Notes**            | Internal notes added by staff                 |
| **Consent**          | SMS and email opt-in status                   |

### Fan enrichment

Fanhaven automatically enriches fan profiles with additional data:

* **Geographic data** — City, state, and country based on phone number or purchase location
* **Demographic data** — Age range and other demographic indicators when available
* **Email validation** — Checks that email addresses are valid and deliverable
* **Phone validation** — Verifies phone numbers are active and reachable

## How fans enter your database

Fans are added through multiple channels:

| Source              | How it works                                        |
| ------------------- | --------------------------------------------------- |
| **POS capture**     | Staff enters the fan's phone number during checkout |
| **Fanpass sign-up** | Fan signs up through the Fanpass page               |
| **Online purchase** | Fan creates an account when buying merch online     |
| **Manual sign-up**  | Staff manually adds a fan (with OTP verification)   |
| **Import**          | Bulk upload fans from a CSV or other source         |
| **Referral**        | New fan signs up via a referral code                |

## Search and filter

Find specific fans using:

* **Name search** — Search by first or last name
* **Phone/email** — Look up by contact info
* **Segments** — Use saved segments to filter (see [Segments](/fans/segments))
* **Purchase behavior** — Filter by spend amount, item purchased, or number of purchases
* **Event** — Find fans from a specific show
* **Fanpass status** — Filter by active/inactive Fanpass

## Fan notes

Add internal notes to any fan profile. Notes are visible to all team members with access and are useful for:

* Recording VIP status or special requests
* Flagging issues (e.g., "disputed a charge on 3/15")
* Tracking interactions outside the system

## Custom fields

Extend fan profiles with **custom fields** to track data specific to your operation. Custom fields appear on fan profiles and can be used for segmentation and filtering.