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.

Kirby Panel

SEO Audit

SEOOK
ReadabilityGood

Good

11
Images: Good job.
Outbound links: Good job.
Internal links: You have enough internal links. Good job.
SEO title width: Good job.
Paragraph length: There are no paragraphs that are too long. Great job.
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

2
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-audit to the blueprint's buttons and 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 adds persisted to remember its last report, the view button adds theme.

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 lang attribute.
  • 🔒 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:

GroupDescriptionVisual Indicator
Good✅ Results that pass their assessmentGreen indicators
OK⚠️ Areas that could be improved but are not criticalOrange indicators
Needs improvement❌ Issues that should be addressedRed indicators
Feedback💡 Suggestions for further improvementsGray indicators
Errors🚫 Assessments that could not runGray indicators

Get Started

Ready to optimize your content for search engines?

Installation Guide

Install the plugin and add the view button or section to a blueprint.