Content health indicators
Topicary tracks content health across these dimensions. Indicators appear on the Topics listing page and in the validation panel.
Topic-level indicators
Indicator | Condition | Severity | Category |
|---|---|---|---|
Stale (amber) | Not updated in 30–89 days | Warning | Freshness |
Stale (red) | Not updated in 90+ days | Error | Freshness |
Empty | Topic has no content | Warning | Completeness |
Orphaned | Topic not included in any map | Warning | Structure |
Broken component ref | References a deleted component | Error | Integrity |
Broken topic link | Links to a deleted topic | Error | Integrity |
Undefined variable | Uses a variable key not in any set | Error | Integrity |
Stale condition | References a deleted condition value | Warning | Integrity |
Missing heading | Topic has no H1 heading | Warning | Structure |
Heading hierarchy skip | Jumps from H1 to H3 without H2 | Warning | Structure |
Filtering by health
On the Topics page, use the filter options to show only topics with specific health issues. This is useful during content audits.
During content audits, combine health filters with status and tag filters to narrow results. For example, filter to "Stale (red)" + status "Published" to find the highest-priority fixes — outdated content that readers are actively seeing.
Validation panel
In the map editor, the Validation panel (right sidebar) runs on-demand validation across all topics in the map:
Click the validation icon in the right panel rail.
Click Validate to run all checks.
Results are grouped by topic, with severity icons (error, warning, info).
A badge count shows the total number of findings.
Dashboard health cards
The project dashboard shows health summary cards:
Card | What it counts |
|---|---|
Stale topics | Topics not updated in 30+ days |
Empty topics | Topics with no content |
Broken references | Deleted component or topic link references |
Undefined variables | Variable tokens with no matching key in any set |
Click any card to navigate to the filtered Topics list.
See also
Content health and governance — broader guide to maintaining content quality across your project
Track content freshness — how staleness indicators work and how to set review cadences
Find and fix orphaned components — identify unreferenced components alongside orphaned topics
Content statuses — workflow statuses that complement health indicators for content governance