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

# Account Health & Hierarchy

> Understand how account health scores are calculated, manage parent-child account hierarchies, and navigate your Book of Business.

Statisfy provides AI-powered health scoring and account hierarchy management to help you monitor customer risk and organize complex account structures.

### Health Scoring

Account health scores give you a quick visual indicator of how each customer is doing. Health is displayed as a color-coded badge on each account.

**Health Levels:**

Statisfy uses a 7-point health scale:

| Level                 | Description                                                         |
| --------------------- | ------------------------------------------------------------------- |
| **Very Positive**     | Account is thriving with strong engagement across all areas         |
| **Positive**          | Account is performing well with healthy interaction patterns        |
| **Slightly Positive** | Account is generally on track with minor areas to watch             |
| **Neutral**           | Account shows mixed signals — no strong positive or negative trends |
| **Slightly Negative** | Account shows early warning signs that need attention               |
| **Negative**          | Account has multiple concerning indicators — action recommended     |
| **Very Negative**     | Account requires immediate intervention to prevent churn            |

### How Health Is Calculated

Statisfy uses AI to calculate health scores based on multiple factors:

<Accordion title="Relationship">
  Measures the frequency and recency of interactions with the account. Accounts with regular meetings, emails, and engagement score higher.
</Accordion>

<Accordion title="Experience">
  Analyzes the tone and outcomes of customer interactions. Frequent escalations or negative sentiment lower the health score.
</Accordion>

<Accordion title="Product Usage">
  Tracks how actively the account uses your product (when product usage data is integrated). Declining usage is a leading indicator of churn risk.
</Accordion>

<Accordion title="Outcomes">
  Evaluates business outcomes and results for the account, including renewal status and value delivered.
</Accordion>

<Accordion title="Feature Requests">
  Tracks open feature requests and product feedback from the account. A high volume of unaddressed requests may signal dissatisfaction.
</Accordion>

<Accordion title="Risks">
  Identifies risk signals across all data sources, including overdue renewals, declining engagement, and negative sentiment trends.
</Accordion>

<Note>
  Health scores update automatically as new data flows into Statisfy. You can also manually override the AI-calculated health if you have additional context.
</Note>

### Viewing Health Details

To see the detailed breakdown of a health score:

1. Navigate to the account detail page
2. Click on the **Health** badge
3. Review the individual factor scores and their contribution to the overall health

### Health-at-Date Columns

You can add historical health columns to the Accounts list to see what an account's health was on a specific date. This is useful for tracking health trends and understanding how account health has changed over time.

**Adding health-at-date columns:**

1. Open the **column selector** on the Accounts list page
2. Look for health-at-date column options and add one or more to your view
3. The column displays the raw sentiment value (e.g., "Good", "Poor") for each account on that date

**Filtering by health on a specific date:**

* Apply a segment filter on a health-at-date field to find accounts that had a particular health status on a given date
* Combine with other filters (e.g., ARR, account owner) for more targeted analysis

<Tip>
  After adding health-at-date columns, save your view so the columns persist when you return to the Accounts page.
</Tip>

### Health Source and Last Modified Columns

Each health factor — Relationship, Experience, Product Usage, Outcomes, Feature Requests, and Risks — plus the overall health score has two companion columns you can add to the Accounts list:

* **Source** — shows whether the score came from **AI** or was set manually. A score displays as **Manual** when someone entered it by hand or overrode the AI-calculated value.
* **Last Modified** — shows the date the score last changed.

**Adding the columns:**

1. Open the **column selector** on the Accounts list page
2. Under **Overall Health Pillars**, add the **Source** and/or **Last Modified** column for the health factors you want to track
3. Save your view to keep the columns in place

**Filtering:**

* **Source** supports a checkbox filter — for example, select **Manual** to find every account where someone overrode the AI health score
* **Last Modified** supports a date filter — for example, find accounts whose health hasn't been updated in the last 30 days

<Tip>
  Combine a **Source = Manual** filter with **Last Modified** to spot stale manual overrides — accounts where a teammate set the health by hand long ago and the score may no longer reflect reality.
</Tip>

### Account Hierarchy

Many organizations have complex account structures with parent companies, subsidiaries, and divisions. Statisfy supports parent-child account hierarchies to reflect these relationships.

**Hierarchy Tree View:**

The hierarchy tree displays the full organizational structure:

* **Parent accounts** appear at the top level
* **Child accounts** are nested underneath their parent
* The tree can be expanded or collapsed at each level
* Each node shows the account name, health, and ARR

### Managing Hierarchies

To set up or modify account hierarchies:

1. Open the account detail page for the child account
2. In the account information section, find the **Parent Account** field
3. Search for and select the parent account
4. Save your changes

The parent account will now show the child in its hierarchy tree, and aggregate metrics (like total ARR) will roll up to the parent level.

### Book of Business

Your **Book of Business** is the set of accounts assigned to you as the account owner.

**Accessing your book:**

* Navigate to **Accounts** — your book of business loads by default
* Use the owner filter to switch between **My Book**, **Team Book**, or **All Accounts**

**Book of Business metrics include:**

* Total accounts and ARR
* Health distribution across your accounts
* Upcoming [renewals](/accounts/renewals)
* Recent activity summary

<Tip>
  Review your Book of Business weekly to catch declining health scores early and prioritize outreach to at-risk accounts. See [Account Page Navigation](/accounts/account_page_navigation) for details on navigating individual account pages.
</Tip>
