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

# ICPs

> Ideal Customer Profiles represent who your pages are written for. They shape the audit prompts zued generates.

**ICPs** (Ideal Customer Profiles) tell zued who your content is addressing. zued uses them to generate more realistic audit prompts — prompts that reflect the context and intent real users carry into AI conversations, rather than generic, one-size-fits-all queries.

## How zued builds ICPs

zued doesn't ask you to create ICPs from scratch. It extracts them from your page content automatically:

1. **Signal extraction** — as each URL is crawled, zued identifies who the page is written for: the situation it addresses, the pain points it speaks to, the language and vocabulary it uses, and the level of background knowledge it assumes. A single page can contribute multiple persona signals.

2. **Profile merging** — similar personas detected across different pages are merged into unified profiles. For example, "Marketing-Leiter im B2B" and "B2B marketing manager" are recognized as the same persona regardless of language or wording.

3. **URL mapping** — each ICP is linked to the specific pages whose signals contributed to it. This mapping determines which ICPs are used when generating prompts for a specific URL. A URL with strong signal contribution to an ICP gets that ICP's context embedded in its prompts.

4. **Confirmation** — you review and confirm (or edit) the generated ICPs before any prompts are created.

<Info>
  The strength of an ICP is indicated by how many pages contributed to it. An ICP backed by signals from 3+ pages is more reliable than one from a single page.
</Info>

## What each ICP contains

| Field              | What it captures                                                          |
| ------------------ | ------------------------------------------------------------------------- |
| Context            | Who the profile represents — the role or situation                        |
| Core situation     | What's driving their search                                               |
| Primary pain point | The specific problem or question                                          |
| Emotional driver   | The motivation behind the search (urgency, aspiration, frustration, etc.) |
| Language style     | How they communicate — casual, professional, technical, or analytical     |
| Search behavior    | How they approach finding solutions                                       |
| Key needs          | The specific outcomes they're looking for                                 |

## Editing ICPs

During review, before you confirm, you can edit the following fields on any ICP:

* **Context** — free text
* **Core situation** — free text
* **Primary pain point** — free text
* **Emotional driver** — select: Urgency, Pressure, Frustration, Aspiration, Curiosity, Fear
* **Language style** — select: Casual, Professional, Technical, Analytical
* **Search behavior** — select: Thorough Researcher, Quick Decision Maker, Analytical Validator, Network-Driven
* **Key needs** — comma-separated list

### Adding and removing profiles

During review you can also add a profile that the automatic extraction missed, or delete one that doesn't fit. A profile you add starts blank — fill in at least its situation and pain point before confirming. zued won't let you confirm while any profile is still empty, since an empty profile produces meaningless prompts.

### Managing pages per profile

Each profile lists the pages mapped to it. From that list you can add another of your project's pages to the profile, move a page to a different profile, or remove a page from the profile. Pages you map by hand are marked as added manually (they carry no extracted signal evidence). Page management is available during review, before you confirm.

<Tip>
  Keep edits close to the original — the ICP is linked to specific URLs based on how it was generated. Major changes may make the ICP-to-URL mapping less meaningful, which reduces prompt precision.
</Tip>

<Warning>
  Editing ICPs after prompts have been created requires re-generating prompts, which resets the week-over-week comparison baseline.
</Warning>
