ContentGrapher
AboutResearchHelp Docs
Analyze →
ContentGrapher
Analyze →
AboutResearchHelp Docs
← All reference pages

Audience Specification

How the reader knowledge level changes the analysis, what each level does, and when to set it.

Why the knowledge level changes the analysis

ContentGrapher derives the explanation framework, the required concept structure, from your topic and your reader together. The same topic analyzed for a beginner requires different concepts, at different depths, than the same topic analyzed for an expert.

A guide to Kubernetes networking analyzed for a reader new to Kubernetes needs more prerequisite concepts and more foundational depth. The same guide analyzed for an expert needs the routing internals and failure modes instead, and can assume the fundamentals.

The three levels

Audience is a single dropdown with three values: Beginner, Intermediate, and Expert. The level sets the assumed baseline knowledge of your reader, which calibrates how deep the analysis expects each concept to be explained.

Beginner emphasizes foundational concepts and definitions, so fundamentals become required. Intermediate, the default, balances depth and accessibility. Expert assumes domain knowledge and shifts the emphasis to advanced depth, so foundational concepts are deprioritized.

Set the level to match your reader. Choosing Expert when the real reader is Intermediate will produce a gap list that omits concepts your readers actually need.

When do I set the level?

Set the level before you start the analysis. The selector "Reader knowledge level" shows below the page input. Choose the level, then select "Analyze →".

The analysis then runs in two stages, and you do not start the second stage yourself. The first stage (Phase 1) produces the concept map and the boundary classifications. The full analysis (Phase 2) starts on its own after the map appears, with the level you set. You cannot change the selector while the analysis runs, and the selector no longer shows once the map appears.

Phase 1 is free. Phase 2 uses an analysis credit. The level you choose determines the explanation framework for that credit, so set it before you select "Analyze →".

When the analysis has finished, the report shows its level below the page input, as "Report audience: …", for example "Report audience: Intermediate level".

The page input on the dashboard: the field "Paste a URL", the button "Analyze →" and the line "Best for articles, guides, and explanatory pages.". Below them is "Reader knowledge level", with the selector set to "Intermediate" and the note "Analysis balances depth and accessibility. Default."

Can I change the level after the analysis?

You cannot change the level of a finished analysis, and you cannot run only the full analysis again at another level. To see the page at another level, analyze it again with the other level selected. The whole analysis runs again, both stages, and uses one analysis credit.

When you select "Re-analyze after editing →" in a report, the selector keeps the level of that report and shows it as, for example, "Intermediate level (previous report)". Choose another level in the selector if you want one. If the earlier report did not record its level, the selector says "Earlier audience unknown — choose for this analysis", and the analysis does not start or continue until you choose a level.

You can change the level between re-analyses. This is useful when you write for readers at different knowledge levels and want to understand what each needs from the same page.

Changing the level changes the explanation framework, which will affect the coverage score and the priority tiers even if the content is unchanged, because the required concept emphasis changed. For a meaningful content delta, compare runs at the same level. Use different-level runs to understand what different readers need, not to measure whether your writing improved.

Related topics

→Coverage Score→Next steps→Why does my priority list look different from a colleague's?
← All reference pages