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

# Client personas

> Describe the client types your firm plans for once, so Hazel matches each household to the right one and builds the plan that fits.

You plan differently for an accumulator in their thirties, a couple three years out from retirement, and a household already drawing income. Describe each of those client types once, as a **Client persona**, and Hazel matches every household to the closest one and builds the plan accordingly.

Personas live in **Settings**, then **Planning**, under **Client persona** in the left rail. Your firm already has three, installed the first time anyone opens Planning settings. Planning settings are open to firm owners; see [Roles and permissions](/guides/settings/members/roles-and-permissions).

## What a persona holds

| Field                  | What it does                                                                                                                     |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Name**               | What you call this archetype. Unique within your firm                                                                            |
| **Description**        | Who this persona is for, and what their planning centers on. Hazel matches households against this                               |
| **Age band**           | An optional matching hint, such as 55 to 67. A hint, never a hard rule                                                           |
| **Hazel instructions** | An ordered list of guidance Hazel follows for this client type                                                                   |
| **Plan design**        | This persona's layout, when it differs from the base template                                                                    |
| **Solver assumptions** | Planning values this client type uses instead of your firm defaults, such as **Success threshold** or **Default reserve length** |

Open a persona to edit its name, description, **Hazel instructions** and **Plan design**, or to delete it.

**The age band is set while you create the persona.** The **New persona** dialog has **Age min** and **Age max** fields, both optional, and the persona screen afterwards has no age control. The persona's row in the left rail shows the band.

**Solver assumptions are not edited on the persona screen.** The three personas your firm starts with carry their own, such as HENRY's 85% success threshold. Change a planning value for the whole firm in **Solver assumptions**, or on a single plan by editing the assumption behind the figure it drives. A persona you create with **Starting template** set to a Hazel preset, or to **Copy from** an existing persona, starts with that persona's solver assumptions.

<Note>
  Read [Solver assumptions](/guides/financial-planning/assumptions/solver-assumptions) for what each value does and its default, and [Where numbers come from](/guides/financial-planning/your-data/where-numbers-come-from) for editing an assumption on one plan.
</Note>

## How the match happens

At the start of a build, Hazel picks the closest fit, weighing two signals together rather than in order:

* **The description.** What the persona says it is for, held against what Hazel knows about this household, including the goals it has stated.
* **The age band.** All else being equal, Hazel matches a 58-year-old to a persona banded 55 to 67. A better fit elsewhere still beats a match on age alone.

Both read from what Hazel already knows, so a thin profile matches poorly. See [How Hazel uses the profile](/guides/financial-planning/your-data/how-hazel-uses-the-profile).

If nothing fits well, Hazel builds on the **base template** alone and records that no persona was used. That usually means you are missing a persona for a client type you serve.

### Hazel records the match

Open the plan's **Appendix** and read the **Applied settings** block: a **Persona** row names the matched persona, or reads **None**, and each planning value under it carries the layer that set it. See [Where numbers come from](/guides/financial-planning/your-data/where-numbers-come-from).

The record is stamped when that version is published, so an older version shows what it was built with rather than today's settings.

## Overriding the match

Name the persona you want up front:

```text theme={null}
Build a plan for the Okonkwos using the Business Owner persona,
not the pre-retiree one. He is 58 but the exit drives everything.
```

Or name it afterwards on a built plan, and Hazel rebuilds against it.

<Tip>
  A persona that keeps getting mismatched needs a sharper description. Rewrite it to say plainly who the persona is for.
</Tip>

## What a persona inherits

A persona is built on the base template and follows it until you change something. Its solver assumptions work value by value: the persona carries only what differs and inherits the rest from your firm settings. Its plan design follows the base design live until the first edit on its **Plan design** card, which forks a copy for that persona. See [Inheritance and re-syncing](/guides/financial-planning/settings/personas/inheritance).

Guardrails are firm-wide, and a persona can add one but never remove one. See [Guardrails](/guides/financial-planning/assumptions/guardrails).

## Where to go next

* [Default templates](/guides/financial-planning/settings/personas/default-templates): the three your firm already has, and what each one does.
* [Creating a persona](/guides/financial-planning/settings/personas/creating-a-persona): build your own, field by field.
* [Instructions](/guides/financial-planning/settings/personas/instructions): how to write guidance Hazel follows.
* [Strictness](/guides/financial-planning/settings/personas/strictness): how tightly a persona's layout binds Hazel.