Text Statistics & Readability

Wordsmith provides several helpful methods for getting statistics about text and/or evaluating its readability.

Wordsmith’s statistics/readability methods include:

Text Statistics


Returns the average number of words per sentence in the text.

{% set text %}
I would eat them in a boat.
And I would eat them with a goat.
And I will eat them in the rain.
And in the dark. And on a train!
{% endset %}

{{ averageWordsPerSentence(text) }}

# 6.2


Returns an approximate count of sentences in the text.

(The sentence count returned by this function should be treated as a rough approximation. Extra periods in the text, such as in words like “Mr.” or “Mrs.”, will prevent the count from being exactly accurate.)

{% set text %}
She sells seashells by the seashore.
The shells that she sells are seashells, I'm sure.
{% endset %}

{{ sentenceCount(text) }}

# 2


An alias for wordcount.


Counts the number of words inside string. (Returns an integer number.)

wordcount strips tags from the provided text, so it will provide a correct value when used on HTML content.

(Bonus: Unlike PHP’s str_word_count, Wordsmith’s wordcount is multi-byte-safe and locale-agnostic.)

{% wordcount('Peter piper picked a peck of pickled peppers.') %}

# 8

Reading Time


Calculates the units of time required for an average person to read the given passage of text.

(By default, this method assumes a 200 words-per-minute English reading rate and returns the number of minutes needed to read a passage at that rate.)

You can optionally specify your own reading rate, to accommodate a different language or compensate for reading difficulty.

You can also optionally specify a minimum number of units, which serves as a floor for the returned value.


{% set tales %}
Whan that aprill with his shoures soote
The droghte of march hath perced to the roote,
And bathed every veyne in swich licour
Of which vertu engendred is the flour;
Whan zephirus eek with his sweete breeth
Inspired hath in every holt and heeth
Tendre croppes, and the yonge sonne
Hath in the ram his halve cours yronne,
And smale foweles maken melodye,
That slepen al the nyght with open ye
(so priketh hem nature in hir corages);
Thanne longen folk to goon on pilgrimages,
And palmeres for to seken straunge strondes,
To ferne halwes, kowthe in sondry londes;
And specially from every shires ende
Of engelond to caunterbury they wende,
The hooly blisful martir for to seke,
That hem hath holpen whan that they were seeke.
{% endset %}

{{ tales | readTime }}

# 1

{{ readTime(tales, minimum=5) }}

# 5



Gives the Automated Readability Index of the text, from 0 to 12.


Gives the Coleman-Liau Index of the text, from 0 to 12.


Gives the Dale-Chall readability score of the text, from 0 to 10.


Gives the Flesch-Kincaid Reading Ease of the text, from 0 to 100.


Gives the Flesch-Kincaid Grade level of the text, from 0 to 12.


Gives the Gunning-Fog score of the text, from 0 to 19.


Gives the SMOG Index of the text, from 0 to 12.


Gives the Spache readability score of the text, from 0 to 5.

(This scale is not really suitable for measuring readability above grade 4.)