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

# Who is a Customer?

A customer in Maestra is any of your customers that we can identify — whether they've placed an order, signed up for a newsletter, or just installed your app. Once a customer lands in your project, Maestra builds them a single profile that tracks who they are, how they engage, and what they've done across every channel.

## What makes someone a customer

Every customer needs at least one **unique contact detail or ID**. Any of the following will do:

* Email address
* Mobile phone number
* Discount card number
* External ID — an ID from your own system (requires a [custom field](/api-integrations/how-to-create-a-custom-field) with field type **Unique ID** and entity **Customer**)
* Mobile app install
* Mobile push device

On top of that, Maestra automatically assigns every customer a **Maestra ID** so you always have a stable internal reference.

## Finding customer profiles

Go to **Customer data platform** → **Customers** to browse every profile in your project.

<img src="https://mintcdn.com/maestraio/-w5Ud9QNiG7Y4nor/images/imported/00_whois.png?fit=max&auto=format&n=-w5Ud9QNiG7Y4nor&q=85&s=3529377dbf50e53e9154417e99779138" alt="All customers list" width="2924" height="838" data-path="images/imported/00_whois.png" />

Click any name to open that customer's profile.

<img src="https://mintcdn.com/maestraio/-w5Ud9QNiG7Y4nor/images/imported/01_whois.png?fit=max&auto=format&n=-w5Ud9QNiG7Y4nor&q=85&s=decc56275163b442120431c13c807297" alt="Customer profile entry" width="2916" height="718" data-path="images/imported/01_whois.png" />

## Navigating the customer profile

<Frame>
  <img src="https://mintcdn.com/maestraio/cjY4riRVnKa6YI10/images/2026-05-07-22.55.30.png?fit=max&auto=format&n=cjY4riRVnKa6YI10&q=85&s=355e8230619143399fe0508536054c1c" alt="2026 05 07 22 55 30" width="2906" height="1642" data-path="images/2026-05-07-22.55.30.png" />
</Frame>

### Main section

The main section is stacked top to bottom:

* Top — core contact and personal info: **email, mobile phone, birthdate, gender, area, and time zone**.
* Middle — **IDs and discount cards**, plus an **ID Changelog** with the full history of identifier updates. To the left, an authentication token — click it to copy the customer's auth token to your clipboard.
* Bottom — the **registration date** and **purchase data**. Click the registration date to jump straight to that moment in the activity feed. For [multi-brand](/administration/multibrand) projects, the customer's first registration date and the brand they signed up under are shown here as well.

**Purchase data**

The profile shows three top-line numbers calculated from the customer's lifetime orders:

* **Order count** — how many orders this customer has placed.
* **Average order value** — total order revenue divided by order count.
* **Total spend** — lifetime revenue from this customer. If you have [RFM segmentation](https://help.maestra.io/segments/how-does-rfm-segmentation-work) set up, the customer's RFM segment is shown alongside it.

<Note>
  **A few things worth knowing about purchase data:**

  * Only orders that fall into the **Placed**, **Paid**, or **Delivered** order status categories are counted. Deleted orders are excluded.
  * Both average order value and total spend are calculated **after** discounts are applied.
  * Values can be copied to the clipboard with the **Copy** button. Without the **View and edit personal data** permission, the copied values come through masked.
  * Purchase data isn't included in customer exports.
</Note>

Below the main section, you'll find a row of tabs with a deeper view of the customer — their activity, the segments they belong to, their subscriptions, and other data tied to the profile: [Activity feed](#activity-feed), [Subscriptions](#subscriptions), [Segments](#segments), [Profile changelog](#profile-changelog), [Custom fields](#custom-fields), and [Product lists](#product-lists).

The customer's devices live in a separate panel on the right side of the profile.

### Devices

The **Devices** section gives you a full picture of every device this customer has used to connect with your brand — across apps, browsers, and customers with shared devices.

**Mobile apps**

<img src="https://mintcdn.com/maestraio/5322-upQA3cGdluA/images/imported/06_whois.png?fit=max&auto=format&n=5322-upQA3cGdluA&q=85&s=6d71c38f5e44b2adc6198bbbebf30dd1" alt="Mobile app installs" width="1412" height="1052" data-path="images/imported/06_whois.png" />

**Browsers**

<img src="https://mintcdn.com/maestraio/nXS6QsINTx63g9ke/images/imported/03_whois.png?fit=max&auto=format&n=nXS6QsINTx63g9ke&q=85&s=e9eeeca351d841b17dbd77fffc026487" alt="Web push browsers" width="1206" height="1008" data-path="images/imported/03_whois.png" />

**Customers with shared devices** — other customers who've signed in on the same device or app:

<img src="https://mintcdn.com/maestraio/cuhKh1pU0z-oNWv0/images/imported/customer_05.png?fit=max&auto=format&n=cuhKh1pU0z-oNWv0&q=85&s=3b3ab8ad9639af79eeae6f90b9164742" alt="Customers sharing a device" width="1450" height="774" data-path="images/imported/customer_05.png" />

### Activity feed

The Activity feed has two tabs: **All activity** and **Bonus points**.

**All activity**

A timeline of everything that's happened with this customer: their own [actions](/customers-orders-and-products/actions/what-is-an-action), anything done on their profile, campaigns sent to them, and personal data updates.

<img src="https://mintcdn.com/maestraio/nXS6QsINTx63g9ke/images/imported/04_whois.png?fit=max&auto=format&n=nXS6QsINTx63g9ke&q=85&s=8591a072bf20d8d29aa120fd7d044581" alt="Customer activity feed" width="2800" height="1332" data-path="images/imported/04_whois.png" />

Filter by date range or activity type to zero in on what you're looking for.

<Frame>
  <img src="https://mintcdn.com/maestraio/1qFdoqKq78TbmYMY/images/1234.png?fit=max&auto=format&n=1qFdoqKq78TbmYMY&q=85&s=30f373b208ee6bc9d21f11e5220388cd" alt="1234" width="2916" height="1560" data-path="images/1234.png" />
</Frame>

**Bonus points**

The customer's current points balance and the full ledger of changes across every bonus account, with the reason for each accrual or deduction.

<img src="https://mintcdn.com/maestraio/cuhKh1pU0z-oNWv0/images/imported/customer_07.png?fit=max&auto=format&n=cuhKh1pU0z-oNWv0&q=85&s=5f873caed22decd2b431ec674e3fb289" alt="Bonus points and rewards" width="1790" height="1192" data-path="images/imported/customer_07.png" />

### Subscriptions

The customer's [opt-in status](/customers-orders-and-products/customers/subscriptions/how-customer-subscriptions-work) across every channel and topic.

<img src="https://mintcdn.com/maestraio/cuhKh1pU0z-oNWv0/images/imported/customer_08.png?fit=max&auto=format&n=cuhKh1pU0z-oNWv0&q=85&s=c98dc4ae66d1de1533619bc872bd3fb9" alt="Subscription statuses" width="1792" height="1050" data-path="images/imported/customer_08.png" />

### Segments

* **Current Segments** — every [segment](/segments/types-of-customer-segments) (both Scheduled and Static) the customer belongs to right now, along with the date they entered it.

<img src="https://mintcdn.com/maestraio/cuhKh1pU0z-oNWv0/images/imported/customer_09.png?fit=max&auto=format&n=cuhKh1pU0z-oNWv0&q=85&s=565df2d1c98bfc9669d510ccc07aebe8" alt="Current segments" width="1794" height="1294" data-path="images/imported/customer_09.png" />

* **Segment history** — when and why the customer entered or left each segment, with the relevant Maestra ID and any merge events flagged. If the profile has been merged with others, you'll see the full segmentation history of every merged customer.

<Frame>
  <img src="https://mintcdn.com/maestraio/1qFdoqKq78TbmYMY/images/2026-05-07-22.28.43-1.png?fit=max&auto=format&n=1qFdoqKq78TbmYMY&q=85&s=4ea7cbd4de01cd5d4a78fcef59c75110" alt="2026 05 07 22 28 43 1" width="2888" height="1418" data-path="images/2026-05-07-22.28.43-1.png" />
</Frame>

### Profile changelog

Every change to the customer's personal info — email, area, custom fields, and more, including profile merges. For each entry you'll see what changed, when, at which touchpoint, who made the change, and the details of the change itself. Filter by date range to narrow it down.

<img src="https://mintcdn.com/maestraio/5322-upQA3cGdluA/images/imported/05_whois.png?fit=max&auto=format&n=5322-upQA3cGdluA&q=85&s=19aaee6c690921e94ef397a0c60675e7" alt="Profile changelog" width="2774" height="1218" data-path="images/imported/05_whois.png" />

### Custom fields

All [custom](/api-integrations/how-to-create-a-custom-field) and [computed fields](/api-integrations/computed-fields) stored on this customer profile.

<Frame>
  <img src="https://mintcdn.com/maestraio/1qFdoqKq78TbmYMY/images/2026-05-07-22.35.46.png?fit=max&auto=format&n=1qFdoqKq78TbmYMY&q=85&s=774d341083997b31bc87e1bda606b190" alt="2026 05 07 22 35 46" width="2888" height="734" data-path="images/2026-05-07-22.35.46.png" />
</Frame>

### Product lists

Every product the customer has added to their product lists — favorites, wishlists, and any custom lists you've defined.

<Frame>
  <img src="https://mintcdn.com/maestraio/1qFdoqKq78TbmYMY/images/-%E2%80%94-2026-05-07-2.39.00.png?fit=max&auto=format&n=1qFdoqKq78TbmYMY&q=85&s=73115c63e90107c51f7c6bcb18cebcda" alt="— 2026 05 07 2 39 00" width="2876" height="1034" data-path="images/-—-2026-05-07-2.39.00.png" />
</Frame>

## What you can do from a customer profile

From any profile, you can:

* [Edit customer details](/customers-orders-and-products/customers/add-edit-export-delete/how-to-edit-customer-data-in-the-profile)
* [Update subscriptions](/customers-orders-and-products/customers/subscriptions/how-to-subscribe-or-unsubscribe-a-customer-in-their-profile)
* Issue actions

## Adding customers to your project

There are four ways to get customers into Maestra:

* [Manually](/customers-orders-and-products/customers/how-to-add-a-customer-manually-via-the-user-interface), one at a time
* [Bulk import from a file](/customers-orders-and-products/customers/how-to-bulk-import-customers-from-a-file)
* Import from an FTP server
* Via [API](https://developers.maestra.io/docs/bulk-import-of-customers)
