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

# Customers overview

> See how your customer portfolio is doing: active customers, health tiers, score changes, and your top accounts on a single page.

The customers overview is the first page of **Customers**. It shows how many customers are active, how healthy they are, which accounts moved, and where your revenue sits.

![](https://mintcdn.com/hyperline/63NYenLoFG6VneMW/images/customers/customers-overview.png?fit=max\&auto=format\&n=63NYenLoFG6VneMW\&q=85\&s=b685925a722fd52e3799ca193990a89c)

> [!NOTE]
>
> The health sections (tiers, distribution, dimensions, and score changes) require [Customer intelligence](https://docs.hyperline.co/docs/customer-intelligence/overview.md) and a [monitoring agent](https://docs.hyperline.co/docs/customer-intelligence/customer-monitoring-agent.md) that scores your customers. Without it, the page shows the customer figures and your top customers.

## Choose what you see

The selectors at the top of the page define the scope of the overview.

**View** sets whose customers are included:

* **All customers** (default): every customer in your account.
* **Me**: the customers you own.
* **My team** and **Me and my team**: available to managers, based on the [manager](https://docs.hyperline.co/docs/account/users-permissions.md#set-a-members-manager) set on each team member.
* A team member: search a person to see only their customers.

**Period** sets the time range of the figures. It defaults to the current month. Pick a preset or any date range: figures are compared with the period of the same length just before.

**Filters** narrows the overview by customer segment or country.

## Customer figures

Three cards summarize your portfolio over the selected period:

* **Active customers**: customers with at least one active subscription at the end of the period.
* **New active customers**: customers who became active during the period.
* **Average ARR per customer**: the estimated ARR of your active customers, from their active and pending subscriptions, divided by their number.

Each card shows the change compared with the previous period. Amounts are converted into your account currency. Customers whose currency can't be converted are left out, and the page tells you how many.

## Health tiers

Your active customers are grouped by their latest health score at the end of the period:

| Tier | Customers included |
| - | - |
| **At risk** | Lowest scores |
| **Medium** | Scores in the middle range |
| **Healthy** | Highest scores |
| **Unscored** | Active customers not analyzed yet |

Each tier shows its number of customers and the estimated ARR they represent. You set the score range of each tier in your customer settings, under **Health score tiers**.

Click a tier to open its active customers in the customers list.

## Health distribution over time

Two charts show, week by week, the share of your customers and the share of your ARR in each tier. Use the ARR chart to see whether the revenue at risk grows, even when the number of customers at risk stays flat.

![](https://mintcdn.com/hyperline/63NYenLoFG6VneMW/images/customers/customers-overview-health.png?fit=max\&auto=format\&n=63NYenLoFG6VneMW\&q=85\&s=f27cee8bd4b91646aba81f6987758dbf)

## Dimension details

The health score combines five dimensions: **Payments**, **Usage**, **Contract**, **Support**, and **Communications**. For each one, you see the average score of your customers, its change over the period, and how customers are distributed across tiers. Hover the distribution to see the details.

![](https://mintcdn.com/hyperline/63NYenLoFG6VneMW/images/customers/customers-overview-dimensions.png?fit=max\&auto=format\&n=63NYenLoFG6VneMW\&q=85\&s=4bd55215d9779d547ffe76cc8ec30349)

## Health score changes

**Health score declines** and **Health score improvements** list the customers whose score moved by 5 points or more over the period, largest change first.

The change compares the customer's score at the start of the period with their latest score at the end. A score that dropped and came back during the period doesn't appear. Each row shows the date of the latest score, the change, and the customer's estimated ARR.

![](https://mintcdn.com/hyperline/63NYenLoFG6VneMW/images/customers/customers-overview-score-changes.png?fit=max\&auto=format\&n=63NYenLoFG6VneMW\&q=85\&s=a382ace8680625889d7bcc2b5a8b37b3)

Click a row to open the analysis behind the score.

## Top customers

Your five largest active customers by estimated ARR, with their health score, subscriptions, and owner.

![](https://mintcdn.com/hyperline/63NYenLoFG6VneMW/images/customers/customers-overview-top-customers.png?fit=max\&auto=format\&n=63NYenLoFG6VneMW\&q=85\&s=2e3a83e51c6e2d50cfa1648f92729d2f)

Click a customer to open their latest analysis, or their customer page when they haven't been scored. Click **View all** to open the customers list sorted by estimated ARR.

## Related pages

* [Customers](https://docs.hyperline.co/docs/customers/overview.md)
* [Customer intelligence](https://docs.hyperline.co/docs/customer-intelligence/overview.md)
* [Customer monitoring agent](https://docs.hyperline.co/docs/customer-intelligence/customer-monitoring-agent.md)


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