--- title: "Changelog" description: "Latest features, fixes, and improvements. Update via Composer or download the ZIP file." canonical_url: "https://kirby.tools/seo-audit/changelog" --- # Changelog > Latest features, fixes, and improvements. Update via Composer or download the ZIP file. ## v3.4.0 Released 2026-08-10 **🚀 Features** - **Kirby queries in the view button**: [`keyphrase`](/docs/seo-audit/configuration/local#keyphrase) and [`synonyms`](/docs/seo-audit/configuration/local#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. ## v3.3.0 Released 2026-08-06 **🔒 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`](/docs/seo-audit/configuration/global#urlresolver) and [`params`](/docs/seo-audit/configuration/global#params) keep working as before. ## v3.2.1 Released 2026-01-25 **🐞 Bug Fixes** - **URL resolver**: Fixed [`urlResolver`](https://kirby.tools/docs/seo-audit/configuration/global#urlresolver) type check to properly validate closures. ## v3.2.0 Released 2026-01-22 **🚀 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. ## v3.1.0 Released 2026-01-03 **🚀 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. ## v3.0.1 Released 2025-09-11 **🚀 Features** - **Enhanced debug logging**: Improved console logging in the browser's developer tools helps diagnose issues with SEO analysis. Set [`logLevel: debug`](/docs/seo-audit/configuration/local#loglevel) in your section configuration to see detailed information about the analysis process, including fetched HTML content and assessment results. ## v3.0.0 Released 2025-09-04 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. No need for a new license key! If you have a valid license for Kirby SEO Audit v2, you can just update the plugin to v3 and continue using it as before. ![Kirby SEO Audit showing analysis results dialog](/img/kirby-seo-audit-analysis-results.png) **🚀 Features** - **View Button**: New [View Button](/docs/seo-audit/configuration/local#view-button-configuration) 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:
Old Name (v1/v2) New Name (v3)
ParagraphTooLong textParagraphTooLong
OutboundLinks externalLinks
PageTitleWidth titleWidth
TextImages images
TitleKeyword keyphraseInSEOTitle
UrlKeyword slugKeyword
KeywordDensity keyphraseDensity
SubheadingDistributionTooLong subheadingsTooLong
TransitionWords textTransitionWords
SentenceLengthInText textSentenceLength
**Removed assessments** (no longer available in Yoast SEO v3): - `fleschReadingEase` - `SentenceLengthInDescription` - `KeywordStopWords` ## v2.1.0 Released 2025-06-24 **🚀 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](https://getkirby.com/releases/5/plugin-license) conventions. This provides a unified view of all plugin licenses alongside Kirby's own license information. ## v2.0.0 Released 2024-12-20 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](https://hub.kirby.tools) to get your discount or read more in the [license compatibility guide](https://kirby.tools/license-compatibility). **🚀 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. ## v1.9.0 Released 2024-11-11 **🚀 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](/docs/seo-audit/guide/assessments) instead of failing silently, helping you choose appropriate assessments for your content language. ## v1.8.0 Released 2024-09-11 **🚀 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. ```yaml [sections/seo-audit.yml] type: seo-audit contentSelector: "#main:not(.sidebar):not(.footer)" logLevel: info ``` ## v1.7.0 Released 2024-06-18 **🚀 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](https://hub.kirby.tools) to purchase or manage licenses. - **Packagist distribution**: The plugin is now available via [Packagist](https://packagist.org/packages/johannschopplich/kirby-seo-audit), simplifying Composer-based installations. The private Composer repository has been deprecated. ## v1.6.0 Released 2024-04-10 **🚀 Features** - **Content scope selection**: The new [`contentSelector`](/docs/seo-audit/configuration/local#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. ```yaml [sections/seo-audit.yml] type: seo-audit contentSelector: "#main-content" ``` ## v1.5.0 Released 2024-03-24 **🚀 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`](/docs/seo-audit/configuration/local#keyphrase) - [`synonyms`](/docs/seo-audit/configuration/local#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: ```yaml [sections/seo-audit.yml] type: seo-audit keyphrase: "{{ page.title.value }}" synonyms: - Kirby - SEO - Audit ``` ## v1.4.2 Released 2024-03-13 **🐞 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. ## v1.4.1 Released 2024-03-12 **🐞 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. ## v1.4.0 Released 2024-03-09 **🚀 Features** - **Synonyms field**: [`synonymsField`](/docs/seo-audit/configuration/local#synonymsfield) option to add synonyms to the page's keyword or keyphrase. - **Custom SEO checks**: [Custom SEO checks](/docs/seo-audit/guide/assessments#kirby-seo-audit-custom-assessments-3) 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. ## v1.3.0 Released 2024-03-08 **🚀 Features** - **Improved proxy configuration**: Replaced the global `transformers.proxyUrl` option with a more flexible [`proxy`](/docs/seo-audit/configuration/global#proxy-configuration) 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()`](https://getkirby.com/docs/reference/objects/http/remote/request) method for custom headers, authentication, or timeout settings. ## v1.2.0 Released 2024-03-07 **🚀 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. ## v1.1.0 Released 2024-03-06 **🚀 Features** - **Report persistence control**: The new [`persisted`](/docs/seo-audit/configuration/local#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. ## v1.0.0 Released 2024-03-05 **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`](/docs/seo-audit/configuration/local#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](/docs/seo-audit/getting-started/installation). --- Every page of this site as Markdown: