Skip to main content
Version: v3.1.1

Clarity

The Clarity metric judges whether text is easy to read, with a higher score indicating that the provided text is easier to read. It is based on the Flesch Reading Ease.

Clarity will be increased by the use of:

  • Short sentences
  • Short words

Clarity will be decreased by the use of:

  • Long sentences
  • Long words

FAQs

What is the difference between Clarity and Simplicity?

The Clarity and Simplicity metrics work together to assess overall readability, and as such assess different things. Clarity is based on the complexity of words (i.e the number of syllables), whereas Simplicity is based on the rarity of words (i.e how often they show up in standard language). A sentence consisting of words with many syllables will have low clarity but may still be easy to understand (e.g. high simplicity) if each word used is common.

As an example, consider the sentence:

"Education is important to communicate information, celebrate community, and provide motivation for every opportunity and situation that requires attention."

This scores a clarity score of 0 as the words used have many syllables, but a simplicity score of 75 as they are common.

How do I interpret the Clarity score?

The Clarity score can be easily mapped to levels of education [1] for a more intuitive understanding:

ScoreUS School LevelUK School Level
90 - 1005th gradeYear 6
80 - 906th gradeYear 7
70 - 807th gradeYear 8
60 - 708th-9th gradeYear 9-10
50 - 6010th-12th gradeYear 11-13
30 - 50CollegeUniversity
0 - 30College GraduateUniversity Graduate

Citations

[1] Flesch, Rudolf. "How to Write Plain English". University of Canterbury. Archived from the original on July 12, 2016.