Readability scores
Score every topic for readability and search engine optimization, and follow the suggestions to improve it.
Only an Owner or Admin can install the addon. Anyone who edits topics can see the scores.
With the Readability & SEO Metrics addon, Sonat checks each topic every time you save it. You get two scores out of 100 and a list of what to fix:
- Readability: how easy the topic is to read, based on Flesch reading ease, sentence and paragraph length, passive voice, transition words and how evenly subheadings break up the text.
- SEO: how well the topic is set up to be found in search engines, based on length, headings, images, links, the meta description and your keyphrase.
Install the addon
- In the left sidebar, select Addons.
- Find Readability & SEO Metrics.
- Select Install.
Scores appear for each topic the next time someone saves it. The addon is free. If you uninstall it, the scores are hidden but kept, and they come back when you install it again.
See a topic's scores
- Open a topic in the editor.
- Look at the two colored dots in the topic header. Hover over one to see the SEO or Readability score.
- Select a dot to open the SEO or Readability panel beside the editor. You can also open them from the side panel tabs or the topic's options menu.

Dot colors:
- Green: above 60, in good shape.
- Yellow: 31 to 60, worth improving.
- Red: 30 or below, needs work.
- Gray: no score yet, or for SEO, no keyphrase set.
Improve a score
Each panel shows the overall score and sorts every check into Errors, Improvements and Good Results. Work through Errors first. Each check explains what it found and what to change.
Set a keyphrase
Several SEO checks look for your keyphrase: the main search term the topic should rank for.
- Open the topic's Settings.
- In Keyphrase, enter up to 4 content words, for example export settings.
- In Description, write a short summary of 120 to 150 characters. Search engines show it under your title.
- Save the topic. The SEO score updates.
What the checks look for
| Score | Checks |
|---|---|
| SEO | Word Count (700 or more is best), Meta Description and its length, H1 and H2 headings, an image and its alt text, Title Length (50 to 65 characters), Keyphrase In Title, In Meta Description, In Slug and In Subheadings, Keyphrase Density, Outbound Links and Internal Links |
| Readability | Flesch Reading Ease, Characters Count, Average Paragraph Word Count, Sentence Count, Passive Voice, Transition Words and Subheading Distribution |
See scores for a whole document
- Open the document.
- Go to More actions › Quality Metrics.
- Review the document's average SEO and readability results. Select a check to see which topics it applies to.
The document average updates as topics are saved, so it can trail your latest edit by one save.
Use scores with judgment
The scores are guides. A short reference page or a step-by-step procedure can be right at 300 words, and some topics don't need an image. Fix what helps readers and leave what doesn't.