# yoast/wordpress-seo architecture

> Architecture diagram of the GitHub repository yoast/wordpress-seo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yoast/wordpress-seo
- Repository: https://github.com/yoast/wordpress-seo

## Overview

Yoast SEO is a WordPress plugin for improving content and site SEO. Its visible JavaScript analysis engine prepares post text as a Paper, runs SEO assessors, and presents results; the repository also contains administration, sitemap, import, and metadata-preview capabilities. The component showcase exposes UI examples, including the snippet editor. The file tree and README establish these product areas, but most PHP runtime wiring is unsampled, so those branches are shown without guessed call relationships.

Main entry points: [`packages/yoastseo/src/app.js`](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/app.js) (Analysis engine), [`apps/components/App.js`](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/App.js) (Showcase app), [`apps/components/SnippetEditorExample.js`](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/SnippetEditorExample.js) (Snippet example), [`index.php`](https://github.com/yoast/wordpress-seo/blob/trunk/index.php) (Plugin entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["WordPress SEO"]
  node_plugin_entry["Plugin entry<br/>[index.php]"]
  node_runtime["Plugin runtime<br/>[main.php]"]
  node_sitemaps["XML sitemaps"]
  node_indexables["Indexables"]
end

subgraph group_analysis["Content Analysis"]
  node_seo_analysis["Analysis engine<br/>[app.js]"]
  node_paper["Analysis paper<br/>[Paper.js]"]
  node_html_parser["HTML parsing<br/>[htmlParser.js]"]
  node_assessors["SEO assessors<br/>[seoAssessor.js]"]
  node_content_assessor["Content assessor<br/>[contentAssessor.js]"]
  node_presenter["Result presenter"]
end

subgraph group_admin["Administration"]
  node_admin_ui["SEO administration<br/>[class-admin.php]"]
  node_seo_settings["SEO settings<br/>[class-config.php]"]
  node_seo_import["SEO migration"]
end

subgraph group_metadata["Search Metadata"]
  node_snippet["Snippet preview<br/>[SnippetPreview.js]"]
  node_social_preview["Social previews"]
end

subgraph group_showcase["UI Showcase"]
  node_component_app["Showcase app<br/>[App.js]"]
  node_showcase_examples["Component examples"]
  node_snippet_example["Snippet example"]
  node_analysis_example["Analysis example"]
end

node_editor(("WordPress editor"))

node_seo_analysis -->|"creates"| node_paper
node_seo_analysis -->|"strips HTML"| node_html_parser
node_seo_analysis -->|"initializes"| node_assessors
node_seo_analysis -->|"uses assessor"| node_content_assessor
node_seo_analysis -->|"uses presenter"| node_presenter
node_component_app -->|"renders"| node_showcase_examples
node_component_app -->|"renders"| node_analysis_example
node_component_app -->|"renders"| node_snippet_example
node_snippet_example -->|"renders"| node_snippet
node_editor -.->|"uses plugin"| node_plugin_entry

click node_plugin_entry "https://github.com/yoast/wordpress-seo/blob/trunk/index.php"
click node_runtime "https://github.com/yoast/wordpress-seo/blob/trunk/src/main.php"
click node_sitemaps "https://github.com/yoast/wordpress-seo/tree/trunk/inc/sitemaps"
click node_indexables "https://github.com/yoast/wordpress-seo/blob/trunk/src/services/indexables/indexable-version-manager.php"
click node_admin_ui "https://github.com/yoast/wordpress-seo/blob/trunk/admin/class-admin.php"
click node_seo_settings "https://github.com/yoast/wordpress-seo/blob/trunk/admin/class-config.php"
click node_seo_import "https://github.com/yoast/wordpress-seo/tree/trunk/admin/import"
click node_seo_analysis "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/app.js"
click node_paper "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/values/Paper.js"
click node_html_parser "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/languageProcessing/helpers/html/htmlParser.js"
click node_assessors "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/assessors/seoAssessor.js"
click node_content_assessor "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/assessors/contentAssessor.js"
click node_presenter "https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/renderers/AssessorPresenter.js"
click node_snippet "https://github.com/yoast/wordpress-seo/blob/trunk/packages/search-metadata-previews/src/snippet-preview/SnippetPreview.js"
click node_social_preview "https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/SocialPreviewEditorWrapper.js"
click node_component_app "https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/App.js"
click node_showcase_examples "https://github.com/yoast/wordpress-seo/tree/trunk/apps/components"
click node_snippet_example "https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/SnippetEditorExample.js"
click node_analysis_example "https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/ContentAnalysisWrapper.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin_entry,node_runtime,node_sitemaps,node_indexables toneBlue
class node_seo_analysis,node_paper,node_html_parser,node_assessors,node_content_assessor,node_presenter toneAmber
class node_admin_ui,node_seo_settings,node_seo_import toneMint
class node_snippet,node_social_preview toneRose
class node_component_app,node_showcase_examples,node_snippet_example,node_analysis_example,node_editor toneIndigo
```

## Components

### WordPress SEO

- [Plugin entry](https://github.com/yoast/wordpress-seo/blob/trunk/index.php): `index.php`
- [Plugin runtime](https://github.com/yoast/wordpress-seo/blob/trunk/src/main.php): `src/main.php`
- [XML sitemaps](https://github.com/yoast/wordpress-seo/tree/trunk/inc/sitemaps): `inc/sitemaps`
- [Indexables](https://github.com/yoast/wordpress-seo/blob/trunk/src/services/indexables/indexable-version-manager.php): `src/services/indexables/indexable-version-manager.php`

### Content Analysis

- [Analysis engine](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/app.js): `packages/yoastseo/src/app.js`
- [Analysis paper](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/values/Paper.js): `packages/yoastseo/src/values/Paper.js`
- [HTML parsing](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/languageProcessing/helpers/html/htmlParser.js): `packages/yoastseo/src/languageProcessing/helpers/html/htmlParser.js`
- [SEO assessors](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/assessors/seoAssessor.js): `packages/yoastseo/src/scoring/assessors/seoAssessor.js`
- [Content assessor](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/assessors/contentAssessor.js): `packages/yoastseo/src/scoring/assessors/contentAssessor.js`
- [Result presenter](https://github.com/yoast/wordpress-seo/blob/trunk/packages/yoastseo/src/scoring/renderers/AssessorPresenter.js): `packages/yoastseo/src/scoring/renderers/AssessorPresenter.js`

### Administration

- [SEO administration](https://github.com/yoast/wordpress-seo/blob/trunk/admin/class-admin.php): `admin/class-admin.php`
- [SEO settings](https://github.com/yoast/wordpress-seo/blob/trunk/admin/class-config.php): `admin/class-config.php`
- [SEO migration](https://github.com/yoast/wordpress-seo/tree/trunk/admin/import): `admin/import`

### Search Metadata

- [Snippet preview](https://github.com/yoast/wordpress-seo/blob/trunk/packages/search-metadata-previews/src/snippet-preview/SnippetPreview.js): `packages/search-metadata-previews/src/snippet-preview/SnippetPreview.js`
- [Social previews](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/SocialPreviewEditorWrapper.js): `apps/components/SocialPreviewEditorWrapper.js`

### UI Showcase

- [Showcase app](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/App.js): `apps/components/App.js`
- [Component examples](https://github.com/yoast/wordpress-seo/tree/trunk/apps/components): `apps/components`
- [Snippet example](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/SnippetEditorExample.js): `apps/components/SnippetEditorExample.js`
- [Analysis example](https://github.com/yoast/wordpress-seo/blob/trunk/apps/components/ContentAnalysisWrapper.js): `apps/components/ContentAnalysisWrapper.js`

### Other components

- **WordPress editor**

## Connections

- Analysis engine → Analysis paper: creates (evidence: `packages/yoastseo/src/app.js`)
- Analysis engine → HTML parsing: strips HTML (evidence: `packages/yoastseo/src/app.js`)
- Analysis engine → SEO assessors: initializes (evidence: `packages/yoastseo/src/app.js`)
- Analysis engine → Content assessor: uses assessor (evidence: `packages/yoastseo/src/app.js`)
- Analysis engine → Result presenter: uses presenter (evidence: `packages/yoastseo/src/app.js`)
- Showcase app → Component examples: renders (evidence: `apps/components/App.js`)
- Showcase app → Analysis example: renders (evidence: `apps/components/App.js`)
- Showcase app → Snippet example: renders (evidence: `apps/components/App.js`)
- Snippet example → Snippet preview: renders (evidence: `apps/components/SnippetEditorExample.js`)
- WordPress editor → Plugin entry: uses plugin
