---
title: "Introduction"
description: "Run Yoast SEO v3 assessments on your Kirby content directly in the Panel – 28 checks for keyphrase, readability, and technical SEO."
canonical_url: "https://kirby.tools/docs/seo-audit/getting-started"
---

# Introduction

> Run Yoast SEO v3 assessments on your Kirby content directly in the Panel – 28 checks for keyphrase, readability, and technical SEO.

Kirby SEO Audit is a plugin for [Kirby CMS](https://getkirby.com) that brings the Yoast SEO v3 analysis engine – the one millions of WordPress users rely on – into the Panel. The analysis runs in the editor's browser; no external services, no data sent to third parties.

![Kirby SEO Audit showing analysis results dialog](/img/kirby-seo-audit-analysis-results.png)

## How It Works

There are two ways to run SEO audits in your Kirby Panel:

- **View Button** <u-badge className="align-text-bottom" color="primary" label="Recommended" size="sm">



</u-badge>

:
Add a single line to your blueprint and get an SEO Audit button in your page header. Click it, and the analysis results appear in a dialog.
- **Section**:
Add a section to your blueprints for inline audit results. Click the "Analyze" button in the section to run the analysis.

Both methods use the same analysis engine – the section adds the `label` and `persisted` properties and resolves Kirby queries in `keyphrase` and `synonyms`.

## Key Features

- 🎛️ **One-Click Analysis**: Run audits from the view button or section.
- 🔍 **28 SEO & Readability Assessments**: Powered by the Yoast SEO v3 engine.
- 🔒 **Local Analysis**: The analysis runs entirely in the browser – no external services involved.
- 📊 **Categorized Results**: Results organized into Good, OK, Bad, and Feedback categories for clear prioritization.
- 🎯 **Keyphrase Analysis**: Advanced keyword density, distribution, and optimization insights.
- 🖼️ **Image SEO**: Automated checks for alt attributes, image optimization, and keyphrase usage.
- 🌐 **Multi-language Support**: Language-specific assessments and region-aware SEO recommendations.
- 🔧 **Flexible Configuration**: Customizable assessments, content selectors, and per-blueprint settings.

## Analysis Categories

Kirby SEO Audit organizes assessment results into four categories to help you prioritize optimization efforts:

<table>
<thead>
  <tr>
    <th>
      Category
    </th>
    
    <th>
      Description
    </th>
    
    <th>
      Visual Indicator
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Good
      </strong>
    </td>
    
    <td>
      ✅ Assessments that pass SEO best practices
    </td>
    
    <td>
      Green indicators
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        OK
      </strong>
    </td>
    
    <td>
      ⚠️ Areas that could be improved but are not critical
    </td>
    
    <td>
      Orange indicators
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Bad
      </strong>
    </td>
    
    <td>
      ❌ Issues that should be addressed for better SEO
    </td>
    
    <td>
      Red indicators
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Feedback
      </strong>
    </td>
    
    <td>
      💡 Suggestions for further improvements
    </td>
    
    <td>
      Gray indicators
    </td>
  </tr>
</tbody>
</table>

## Get Started

Ready to optimize your content for search engines?

<card icon="i-ri-download-line" title="Installation Guide" to="/docs/seo-audit/getting-started/installation">

Install the plugin and start analyzing your content in minutes.

</card>

---

Every page of this site as Markdown: <https://kirby.tools/sitemap.md>