Introduction
Run Yoast SEO assessments on your Kirby content directly in the Panel – keyphrase, readability, and technical SEO checks.
Kirby SEO Audit is a plugin for Kirby CMS that brings the Yoast SEO analysis engine into the Panel. The analysis runs in the editor's browser; no external services, no data sent to third parties.
SEO Audit
SEOOKReadabilityGood
Good
Images: Good job.
Outbound links: Good job.
Internal links: You have enough internal links. Good job.
SEO title width: Good job.
Subheading distribution: Great job.
Paragraph length: There are no paragraphs that are too long. Great job.
Sentence length: Great.
Transition words: You are not using any transition words, but your text is short enough and probably doesn't need them.
Passive voice: You are not using too much passive voice. That's great.
Consecutive sentences: There are no repetitive sentence beginnings. That's great.
Word complexity: You are not using too many complex words, which makes your text easy to read. Good job.
OK
Meta description length: The meta description is too short (under 120 characters). Up to 156 characters are available. Use the space.
Image Keyphrase: Images on this page do not have alt attributes that reflect the topic of your text. Add your keyphrase or synonyms to the alt tags of relevant images.
Unsaved changes · 9/1/26, 8:40 AM
How It Works
There are two ways to run the analysis in your Kirby Panel:
- View Button Recommended:
Add
seo-auditto the blueprint'sbuttonsand an SEO Audit button appears in the page header. Click it, and the report opens in a dialog. - Section: Add a section to your blueprints to show the report inline. Click the "Analyze" button in the section to run the analysis.
Both methods run the same analysis and share their configuration; the section also remembers its last report.
Features
- 🎛️ View Button & Section: Run the analysis from the page header or inline in a section.
- 🔍 SEO & Readability Assessments: Powered by the Yoast SEO engine, plus checks of our own.
- 📊 Result Groups: Every result sorted into Good, OK, Needs improvement, Feedback, or Errors.
- 🚦 SEO & Readability Ratings: One light per category. The view button shows the page's rating, kept per page and language and readable in blueprints and templates.
- ✍️ Unsaved Changes: The analysis reads what the form shows, before the page is published.
- 🎯 Keyphrase Field: Extra checks against the page's keyphrase.
- 🌐 Language-Specific Features: Analysis rules picked from the page's
langattribute. - 🔒 Local Analysis: Runs in the editor's browser, no external service involved.
Result Groups
The report opens with one light per category – SEO and readability – and lists the results in five groups:
| Group | Description | Visual Indicator |
|---|---|---|
| Good | ✅ Results that pass their assessment | Green indicators |
| OK | ⚠️ Areas that could be improved but are not critical | Orange indicators |
| Needs improvement | ❌ Issues that should be addressed | Red indicators |
| Feedback | 💡 Suggestions for further improvements | Gray indicators |
| Errors | 🚫 Assessments that could not run | Gray indicators |