# wordpress/wordpress-develop architecture

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

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

## Overview

WordPress is a PHP, MySQL, and JavaScript platform for creating and managing websites. A principal workflow is a user entering the administration area, editing content or media, and having site content rendered through a theme; the tree also shows distinct REST, customization, authentication, multisite, and site-maintenance capabilities. The graph preserves these as major subsystems. Evidence is limited: only selected sources were excerpted or indexed, so uncertain runtime connections are shown as dashed and unverified rather than asserted.

Main entry points: [`src/wp-admin`](https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-admin) (Admin screens), [`src/index.php`](https://github.com/wordpress/wordpress-develop/blob/trunk/src/index.php) (Site rendering), [`src/wp-admin/admin.php`](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/admin.php) (Admin bootstrap), [`src/wp-includes/blocks/query.php`](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/blocks/query.php) (Block queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and administration"]
  node_login["Login<br/>[wp-login.php]"]
  node_admin["Admin bootstrap<br/>[admin.php]"]
  node_admin_screens["Admin screens"]
  node_app_auth["App passwords"]
  node_multisite["Multisite admin"]
end

subgraph group_content["Content and presentation"]
  node_content_edit["Content editing"]
  node_media_admin["Media management<br/>[media.php]"]
  node_blocks["Block queries<br/>[query.php]"]
  node_themes["Themes"]
  node_frontend["Site rendering<br/>[index.php]"]
end

subgraph group_services["APIs and customization"]
  node_media_api["Media REST"]
  node_posts_api["Posts REST"]
  node_customize["Customizer"]
  node_ai_client["AI client<br/>[AiClient.php]"]
end

subgraph group_platform["Platform services"]
  node_mysql[("MySQL database")]
  node_privacy["Privacy tools<br/>[privacy-tools.php]"]
  node_health["Site health"]
  node_translations["Translations"]
  node_style_engine["Style engine"]
end

node_visitor(("Site user"))

node_visitor -.->|"signs in"| node_login
node_visitor -.->|"opens admin"| node_admin
node_admin -->|"bootstraps"| node_admin_screens
node_app_auth -->|"loads bootstrap"| node_admin
node_admin_screens -.->|"edits content"| node_content_edit
node_admin_screens -.->|"manages media"| node_media_admin
node_media_admin -.->|"uses API"| node_media_api
node_posts_api -.->|"reads and writes"| node_mysql
node_media_api -.->|"stores metadata"| node_mysql
node_content_edit -.->|"stores content"| node_mysql
node_frontend -.->|"renders theme"| node_themes
node_frontend -.->|"renders blocks"| node_blocks
node_blocks -.->|"queries content"| node_mysql
node_customize -.->|"configures display"| node_themes
node_multisite -.->|"manages sites"| node_mysql
node_privacy -.->|"handles requests"| node_mysql
node_health -.->|"reports status"| node_admin_screens
node_translations -.->|"localizes output"| node_frontend
node_style_engine -.->|"processes styles"| node_blocks
node_ai_client -.->|"offers AI capability"| node_visitor

click node_login "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-login.php"
click node_admin "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/admin.php"
click node_admin_screens "https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-admin"
click node_app_auth "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/authorize-application.php"
click node_content_edit "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/edit-form-advanced.php"
click node_media_admin "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/media.php"
click node_media_api "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php"
click node_posts_api "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php"
click node_customize "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/class-wp-customize-manager.php"
click node_blocks "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/blocks/query.php"
click node_themes "https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-content/themes"
click node_frontend "https://github.com/wordpress/wordpress-develop/blob/trunk/src/index.php"
click node_multisite "https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-admin/network"
click node_privacy "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/includes/privacy-tools.php"
click node_health "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/includes/class-wp-site-health.php"
click node_translations "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/l10n/class-wp-translation-controller.php"
click node_style_engine "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/style-engine/class-wp-style-engine.php"
click node_ai_client "https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/php-ai-client/src/AiClient.php"

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_login,node_admin,node_admin_screens,node_app_auth,node_multisite,node_visitor toneBlue
class node_content_edit,node_media_admin,node_blocks,node_themes,node_frontend toneAmber
class node_media_api,node_posts_api,node_customize,node_ai_client toneMint
class node_mysql,node_privacy,node_health,node_translations,node_style_engine toneRose
```

## Components

### Entry and administration

- [Login](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-login.php): `src/wp-login.php`
- [Admin bootstrap](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/admin.php): `src/wp-admin/admin.php`
- [Admin screens](https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-admin): `src/wp-admin`
- [App passwords](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/authorize-application.php): `src/wp-admin/authorize-application.php`
- [Multisite admin](https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-admin/network): `src/wp-admin/network`

### Content and presentation

- [Content editing](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/edit-form-advanced.php): `src/wp-admin/edit-form-advanced.php`
- [Media management](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/media.php): `src/wp-admin/media.php`
- [Block queries](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/blocks/query.php): `src/wp-includes/blocks/query.php`
- [Themes](https://github.com/wordpress/wordpress-develop/tree/trunk/src/wp-content/themes): `src/wp-content/themes`
- [Site rendering](https://github.com/wordpress/wordpress-develop/blob/trunk/src/index.php): `src/index.php`

### APIs and customization

- [Media REST](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php): `src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php`
- [Posts REST](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php): `src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`
- [Customizer](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/class-wp-customize-manager.php): `src/wp-includes/class-wp-customize-manager.php`
- [AI client](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/php-ai-client/src/AiClient.php): `src/wp-includes/php-ai-client/src/AiClient.php`

### Platform services

- **MySQL database**
- [Privacy tools](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/includes/privacy-tools.php): `src/wp-admin/includes/privacy-tools.php`
- [Site health](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-admin/includes/class-wp-site-health.php): `src/wp-admin/includes/class-wp-site-health.php`
- [Translations](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/l10n/class-wp-translation-controller.php): `src/wp-includes/l10n/class-wp-translation-controller.php`
- [Style engine](https://github.com/wordpress/wordpress-develop/blob/trunk/src/wp-includes/style-engine/class-wp-style-engine.php): `src/wp-includes/style-engine/class-wp-style-engine.php`

### Other components

- **Site user**

## Connections

- Site user → Login: signs in
- Site user → Admin bootstrap: opens admin
- Admin bootstrap → Admin screens: bootstraps (evidence: `src/wp-admin/link-manager.php`)
- App passwords → Admin bootstrap: loads bootstrap (evidence: `src/wp-admin/authorize-application.php`)
- Admin screens → Content editing: edits content
- Admin screens → Media management: manages media
- Media management → Media REST: uses API
- Posts REST → MySQL database: reads and writes
- Media REST → MySQL database: stores metadata
- Content editing → MySQL database: stores content
- Site rendering → Themes: renders theme
- Site rendering → Block queries: renders blocks
- Block queries → MySQL database: queries content
- Customizer → Themes: configures display
- Multisite admin → MySQL database: manages sites
- Privacy tools → MySQL database: handles requests
- Site health → Admin screens: reports status
- Translations → Site rendering: localizes output
- Style engine → Block queries: processes styles
- AI client → Site user: offers AI capability
