Audit URL
The audit fetches the same URL as the Panel's open button, so draft pages, custom hostnames, and per-language variants are all in scope. A blueprint with options.preview: false has no such URL, and the audit stops with the error that the preview URL is disabled.
Model Support
The plugin works with any Kirby model that has a previewUrl method:
- Pages: Analyze individual page content.
- Site: Check site-level SEO (homepage, etc.).
Custom Target URL
In certain cases, you might want to customize the target URL used to generate the SEO report. This can be done by adding a preview option to the model's blueprint:
options:
preview: https://getkirby.com/features/developers
sections:
seoAudit:
type: seo-audit
This is particularly useful for:
- Analyzing external URLs
- Testing staging environments
- Checking specific URL variations
Cross-Origin Analysis
A preview URL on the Panel's own origin is fetched by the browser. Any other origin is fetched by Kirby on the server, so CORS never applies – the proxy settings in the global configuration apply only to that fetch.
Language-Specific Analysis
On multi-language sites, the analysis targets the preview URL of the language selected in the Panel, so a secondary language is analyzed against its translated page.
lang attribute of the rendered page – see Assessments for SEO and Readability.Debugging URL Resolution
The browser console always shows the URL the audit starts from, which is the preview URL before any urlResolver rewrite. To see the HTML extracted from the page that was actually fetched, which is the check for a rewrite, set logLevel to info.