Installation

Step 1: Install the Plugin

Although it is a commercial plugin, you can download and test it in your local environment before purchasing.

composer require johannschopplich/kirby-seo-audit

Step 2: Choose Your Workflow

Kirby SEO Audit offers two ways to add SEO analysis to the Panel. Both run the same analysis, share their configuration, and can be used together – the section additionally remembers its last result through persisted.

buttons:
  - seo-audit # Choose position
  - open # `buttons` replaces Kirby's
  - preview # defaults, so list them all
  - "-"
  - settings
  - languages
  - status

seoAudit:
  type: seo-audit

Step 3: Configure Keyphrase Fields (Optional)

SEO assessments that analyze how the keyphrase is used, such as Introduction Keyword, Meta Description Keyword, or Function Words, need a defined keyphrase – see keyphraseField for what happens without one. You can define blueprint fields for the keyword and its synonyms to be analyzed with your page. These fields can be used by both the view button and section:

# Configure the view button to use keyphrase fields
buttons:
  seo-audit:
    keyphraseField: metaKeyphrase
    synonymsField: metaSynonyms
  open: true
  preview: true
  settings: true
  languages: true
  status: true

sections:
  # Define the keyphrase fields
  content:
    type: fields
    fields:
      metaKeyphrase:
        label: SEO Keyphrase
        type: text
        help: The main keyword you want this page to rank for
      metaSynonyms:
        label: Keyphrase Synonyms
        type: tags
        help: Alternative keywords and variations

  # Configure the section to use the same fields
  seoAudit:
    type: seo-audit
    keyphraseField: metaKeyphrase
    synonymsField: metaSynonyms

Step 4: Analyze Your Content

Open the Panel and navigate to the page that you want to analyze. You can start the SEO audit in two ways:

• Using the View Button: Click the SEO Audit button and the analysis results will open in a dialog.
• Using the Section: Click the Analyze button in the section. The results will be displayed directly in the section.

When using the Panel view button, the analysis results will be displayed in a dialog:

Both methods perform the same analysis process:

1. Fetch the HTML content from your page's preview URL.
2. Analyze the content with the SEO and readability assessments.
3. Present results in four clear categories (Good, OK, Needs improvement, Feedback) with actionable recommendations for improvement.

The analysis considers your defined keyphrase and synonyms.

Step 5: Buy a License

You can test the plugin locally. However, you need to purchase a license to use the plugin in production environments.

Visit the buy page and purchase a license. The easiest way to activate your license is to go to the system view in the Kirby Panel and click on Activate now:

Enter the email you used for the purchase and your license key, then hit the submit button. You will find your license key in your order confirmation email or at hub.kirby.tools. Done! Thanks for supporting our work. Once you activate your license, the license activation buttons will disappear.