Our Studio

🚀 Features

• Unsaved changes analyzed: The analysis now reads what the form shows, not only the published page. The report says which one it looked at – "Unsaved changes" or "Published version" – and when.
• SEO and readability lights: The report opens with one light per category, so the verdict comes before the list of checks.
• Ratings: Each analysis leaves a rating per page and language. The view button shows it as a colored dot, with an exclamation mark once the page was published again. Blueprints and templates can read it and sort pages by it.
• Analyze on publish: With analyzeOn: publish, the analysis runs on its own after every publish, silently, so the rating keeps up with the content.
• Yoast SEO 28.5: The analysis engine moves to the current Yoast release. Transition words and the keyphrase in subheadings are now read from the page structure instead of the raw text.

🚨 Breaking Changes

• View button theme: The default is now positive-icon, the icon-only accent Kirby uses for the status button. Set theme: positive to keep the filled button.

🚀 Features

• Kirby queries in the view button: keyphrase and synonyms now resolve Kirby queries for the view button, not just for the section. A keyphrase like {{ page.title.value }} follows the content instead of being analyzed literally.

🐞 Bug Fixes

• Norwegian assessments: A page whose language is no or nn now reaches Yoast's Bokmål researcher. Previously only nb did, and the other two were scored as English.

🔒 Security

• Model-derived proxy target: The proxy now resolves the preview URL from the page itself instead of fetching whatever URL the browser asked for. Prevents any Panel user, whatever their role, from making your server reach internal hosts and services that are otherwise unreachable from the outside. No configuration changes required – the analyzed URL stays the same, and urlResolver and params keep working as before.

🚀 Features

• System view license management: View your license key, activation status, and version compatibility directly in the Kirby Panel system view. Activate new licenses without leaving the Panel – no more manual file editing required.

🚀 Features

• Yoast SEO v3.5: Upgrade to the latest Yoast SEO analysis engine with improved assessments and bug fixes.
• Updated translations: Refreshed translations for German, English, Spanish, French, and Dutch to match the latest Yoast SEO terminology.

🚀 Features

• Enhanced debug logging: Improved console logging in the browser's developer tools helps diagnose issues with SEO analysis. Set logLevel: debug in your section configuration to see detailed information about the analysis process, including fetched HTML content and assessment results.

Kirby SEO Audit v3 is a free upgrade for all users with a valid license key for v2. It includes an upgrade to the underlying analysis engine from Yoast SEO v1 to v3, resulting in better performance, accuracy, and new features.

🚀 Features

• View Button: New View Button for Kirby 5, allowing you to run SEO analysis from any page without adding a section to your blueprint.
• Yoast SEO v3: Upgrade from Yoast SEO v1 to Yoast SEO v3 with overhauled assessments and improved performance.
• Image keyphrase assessment: New assessment imageKeyphrase – Analyzes if images are optimized for your target keyphrase.
• Additional translations: More translations for the generated report: French, Spanish.
• Improved result categories: Improved result categories with Good, OK, Bad, and Feedback indicators for better prioritization.

⚠️ Migration from v1/v2

Several assessment names have changed to match Yoast SEO v3 conventions. Update your blueprints if you use the assessments property:

Removed assessments (no longer available in Yoast SEO v3):

• fleschReadingEase
• SentenceLengthInDescription
• KeywordStopWords

🚀 Features

• Kirby 5 license status integration: The plugin now displays its license status on the Panel's system page, following Kirby 5's plugin license management conventions. This provides a unified view of all plugin licenses alongside Kirby's own license information.

Kirby SEO Audit v2 is a major release with full support for Kirby 5. This major release requires a new license key. If you already have a license, you receive either a free upgrade to v2 or a 50% discount on your new license. Head over to the Kirby Tools Hub to get your discount or read more in the license compatibility guide.

🚀 Features

• Kirby 5 compatibility: Full support for Kirby 5, including the new Panel architecture and updated APIs.
• Dark mode support: The SEO Audit interface adapts to Kirby 5's dark mode, providing a consistent visual experience across the Panel.
• Maintained Kirby 4 support: The plugin continues to work with Kirby 4 projects, allowing you to upgrade at your own pace.

🚀 Features

• Language compatibility validation: The plugin now validates that configured assessments are compatible with the current Panel language. Some Yoast assessments (like transition words) only work with specific languages. If you configure an incompatible assessment, the plugin will show a clear error instead of failing silently, helping you choose appropriate assessments for your content language.

🚀 Features

• HTML logging: If the log level is set to info or higher, log the extracted HTML to the console. Useful for checking the HTML used for the SEO report.

type: seo-audit
contentSelector: "#main:not(.sidebar):not(.footer)"
logLevel: info

🚀 Features

• Panel license activation: Activate and manage your license directly in the Kirby Panel without manual file editing. Click the activation link in the SEO Audit section to enter your license details. Visit the Kirby Tools Hub to purchase or manage licenses.
• Packagist distribution: The plugin is now available via Packagist, simplifying Composer-based installations. The private Composer repository has been deprecated.

🚀 Features

• Content scope selection: The new contentSelector property lets you define a CSS selector for the main content area to analyze. This excludes headers, footers, sidebars, and navigation from SEO analysis, providing more accurate assessments focused on your actual page content.

type: seo-audit
contentSelector: "#main-content"

🚀 Features

• Blueprint-defined keywords: As an alternative to both the keyphraseField and synonymsField properties (which are separate fields that an editor has to fill in) you can define keywords/keyphrases and synonyms directly in the blueprint:
  • keyphrase
  • synonyms

Both of these new properties support Kirby queries. For example, you can use the page title as a keyword next to a list of synonyms:

type: seo-audit
keyphrase: "{{ page.title.value }}"
synonyms:
  - Kirby
  - SEO
  - Audit

🐞 Bug Fixes

• Image alt assessment accuracy: The alt attribute assessment is now skipped when the analyzed content contains no images. Previously, pages without images would show a misleading "Good" result for alt attributes, implying images were checked when none existed. Now the assessment is only shown when relevant.

🐞 Bug Fixes

• Locale format conversion: Kirby's POSIX locale format (like es_ES) is now properly converted to IETF BCP 47 language tag format (like es-ES) for the Yoast SEO engine. This ensures language-specific assessments work correctly regardless of how your Kirby languages are configured.

🚀 Features

• Synonyms field: synonymsField option to add synonyms to the page's keyword or keyphrase.
• Custom SEO checks: Custom SEO checks that complement the default assessments provided by Yoast SEO.
  • Alt attribute: Checks whether all images have an alt attribute.
  • Single H1: Checks whether the content contains a H1 heading.
  • Heading structure order: Checks whether the headings (H1 to H6) follow a proper sequential order.

🚀 Features

• Improved proxy configuration: Replaced the global transformers.proxyUrl option with a more flexible proxy configuration. The new option accepts:
  • urlResolver: Custom function for URL resolution (useful for headless setups or custom domains).
  • params: Options passed directly to Kirby's Remote::request() method for custom headers, authentication, or timeout settings.

🚀 Features

• Proxy URL option: Global transformers.proxyUrl option to further modify the request URL of the content fetcher proxy.

🐞 Bug Fixes

• Proxy error handling: Always return 200 status code from the proxy API path, but log the request error if it occurs.

🏎 Performance

• Reduced bundle size: Externalize Yoast SEO translations into a separate build chunk to reduce the main bundle size.

🚀 Features

• Report persistence control: The new persisted section property controls whether SEO audit reports are saved to local storage. Set to true (default) to keep reports between sessions, or false to always start with a fresh analysis. This is useful when you want editors to run a new audit each time they open a page.

Initial Release

Kirby SEO Audit v1.0 brings comprehensive SEO analysis directly to the Kirby Panel. Built on the Yoast SEO engine, it provides real-time insights and actionable recommendations without external API calls.

🚀 Features

• Yoast SEO integration: Powered by the same analysis engine used by millions of WordPress sites. Run SEO assessments locally in your browser.
• Panel section: Add the SEO Audit section to any page blueprint with type: seo-audit. Click the "Analyze" button to run a complete SEO check.
• Keyphrase analysis: Analyze keyword density, distribution, and optimization opportunities with the keyphraseField option.
• Multi-language support: Language-aware assessments provide region-specific recommendations based on your Kirby language settings.
• SEO & readability assessments: Comprehensive checks for meta descriptions, headings, content length, readability, and more.

For setup instructions, see the Installation guide.