Kirby SEO Audit comes with 28 comprehensive assessments that analyze your content for search engine optimization and readability:
The analysis results are organized into three clear categories to help you prioritize optimization efforts, regardless of whether they are SEO or readability assessments:
| Category | Description | Priority |
|---|---|---|
| Good | ✅ Assessments that pass SEO best practices | Green indicators |
| OK | ⚠️ Areas that could be improved but aren't critical | Orange indicators |
| Bad | ❌ Issues that should be addressed for better SEO | Red indicators |
| Feedback | 💡 Suggestions for further improvements | Gray indicators |
Kirby SEO Audit v3 upgrades from Yoast SEO v1 to v3, bringing significant improvements in performance, accuracy, and new features. The upgrade introduces web worker support for faster, non-blocking analysis and better content parsing accuracy.
Several assessments have been renamed to match Yoast SEO v3 conventions:
| Old Name (v1) | New Name (v3) | Description |
|---|---|---|
ParagraphTooLong | textParagraphTooLong | Paragraph length analysis |
OutboundLinks | externalLinks | External link assessment |
PageTitleWidth | titleWidth | Page title width check |
TextImages | images | Image usage analysis |
TitleKeyword | keyphraseInSEOTitle | Keyphrase in title |
UrlKeyword | slugKeyword | Keyphrase in URL slug |
KeywordDensity | keyphraseDensity | Keyword density analysis |
SubheadingDistributionTooLong | subheadingsTooLong | Subheading length check |
TransitionWords | textTransitionWords | Transition word usage |
SentenceLengthInText | textSentenceLength | Sentence length analysis |
The following 17 SEO assessments are powered by Yoast SEO v3:
introductionKeyword – Introduction KeywordkeyphraseLength – Keyphrase LengthkeyphraseDensity – Keyword DensitymetaDescriptionKeyword – Meta Description KeywordmetaDescriptionLength – Meta Description LengthsubheadingsKeyword – Subheadings KeywordtextCompetingLinks – Text Competing LinksimageKeyphrase – Image Keyphraseimages – Text ImagestextLength – Text LengthexternalLinks – Outbound LinkskeyphraseInSEOTitle – Title KeywordinternalLinks – Internal LinkstitleWidth – Page Title WidthslugKeyword – URL KeywordfunctionWordsInKeyphrase – Function Words in KeyphrasekeyphraseDistribution – Keyphrase DistributionThe following 8 readability assessments are powered by Yoast SEO v3:
subheadingsTooLong – Subheading Distribution Too LongtextParagraphTooLong – Paragraph Too LongtextSentenceLength – Sentence Length in TexttextTransitionWords – Transition WordspassiveVoice – Passive VoicetextPresence – Text PresencesentenceBeginnings – Sentence BeginningswordComplexity – Word ComplexityThe Kirby SEO Audit plugin provides the following three custom SEO assessments to expand on the Yoast SEO assessments:
singleH1 – Checks whether the content contains exactly one H1 heading.headingStructureOrder – Checks whether headings (H1 to H6) follow proper sequential order.altAttribute – Checks whether all images have an alt attribute.While these custom assessments are not part of Yoast SEO, they are specifically designed with best-practice SEO in mind and complement the existing Yoast SEO assessments.
By default, all assessments are enabled. Pick which SEO and readability assessments to include in the report by adding an assessments property to your blueprint, depending on whether you use the view button or section.
buttons:
seo-audit:
# Select the assessments you want to include
assessments:
- metaDescriptionKeyword
- metaDescriptionLength
- titleWidth
- images
- textLength
- imageKeyphrase
type: seo-audit
# Select the assessments you want to include
assessments:
- metaDescriptionKeyword
- metaDescriptionLength
- titleWidth
- images
- textLength
- imageKeyphrase
The following SEO assessments require a keyphrase to be defined via keyphraseField or keyphrase:
functionWordsInKeyphraseintroductionKeywordkeyphraseDensitykeyphraseDistributionkeyphraseInSEOTitlekeyphraseLengthmetaDescriptionKeywordslugKeywordsubheadingsKeywordIf no keyphrase is provided, these assessments will be skipped unless explicitly enabled in the assessments property.
Some assessments are only available in certain languages. The plugin uses the lang attribute of the rendered page's HTML for analysis, while the translations of the SEO results are based on the language selected in the Kirby Panel.
languages/xx.php file matches the ISO 639-1 language code (e.g., use de for German, not ger).| Assessment | Supported Languages |
|---|---|
wordComplexity | de, en, es, fr |
keyphraseDistribution | ar, cs, de, el, en, es, fr, he, hu, id, it, ja, nl, no, pl, pt, ru, sk, sv, tr |
metaDescriptionLength | ar, cs, de, el, en, es, fa, fr, he, hu, id, it, ja, nl, no, pl, pt, ru, sk, sv, tr |
textParagraphTooLong | ar, cs, de, el, en, es, fa, fr, he, hu, id, it, ja, nl, no, pl, pt, ru, sk, sv, tr |
textSentenceLength | ar, cs, de, el, en, es, fa, fr, he, hu, id, it, ja, nl, no, pl, pt, ru, sk, sv, tr |
passiveVoice | ar, cs, de, el, en, es, fa, fr, he, hu, id, it, nl, no, pl, pt, ru, sk, sv, tr |
textTransitionWords | ar, ca, cs, de, el, en, es, fa, fr, he, hu, id, it, ja, nl, no, pl, pt, ru, sk, sv, tr |
functionWordsInKeyphrase | ar, cs, de, el, en, es, fa, fr, he, hu, id, it, nl, no, pl, pt, ru, sk, sv, tr |