Skip to content
Raptor home
Menu

Hard reading

content.readability_difficult
Priority
Low
Severity
Info

What we look for

These pages score below 30 on the Flesch reading-ease scale (0 to 100, worked out from sentence and word length, where higher is easier), but not low enough to count as very hard.

Why it matters

Text in this range suits specialist readers, but a general audience may find it slow going.

How to fix

Shorten long sentences and swap long words for everyday ones where your readers are not specialists, 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_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_difficult"
The HTML report
This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=content.readability_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_difficult"
}