Skip to content
Raptor home
Menu

Very hard reading

content.readability_very_difficult
Priority
Low
Severity
Info

What we look for

These pages score below 10 on the Flesch reading-ease scale (0 to 100, worked out from sentence and word length, where higher is easier).

Why it matters

Text that scores this low reads like dense academic or legal writing, which many visitors give up on.

How to fix

Shorten long sentences, swap long words for everyday ones and break up long paragraphs, in the CMS where the page text is written.

What it cannot know

The score is built for English prose. Other languages, lists and technical terms can lower it without the page being hard for its readers.

Where you’ll see it

The id is stable, and every surface uses it, so it’s the thing to search for or hand to an agent.

Terminal
When it is one of the five findings under Fix first, raptor crawl prints the id under it.
Check: content.readability_very_difficult
crawl.json and the CSV
The crawl JSON names the finding by this id, and so do the CSV and raptor_query.
"check_id": "content.readability_very_difficult"
The HTML report
This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=content.readability_very_difficult
MCP
raptor_findings with this check_id returns the finding in full, with a fix brief ready to paste into a task. If it didn’t fire, it says why.
raptor_findings {
  "job_id": "...",
  "check_id": "content.readability_very_difficult"
}