# umbraco/umbraco-cms architecture

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

- Interactive diagram: https://gitdiagram.com/umbraco/umbraco-cms
- Repository: https://github.com/umbraco/umbraco-cms

## Overview

Umbraco CMS is a .NET content management system. Editors and administrators use the management API to manage content and other CMS resources; published content is served separately through the Delivery API. The graph highlights those interfaces, shared content representations, preview, search, and rendering/query capabilities. Source excerpts directly show the Delivery API query flow and management search execution; broader management features are represented from the file tree, so their internal links are omitted where implementation evidence was not sampled.

Main entry points: [`src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs) (Content queries), [`src/Umbraco.Cms.Api.Delivery/Services`](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Services) (Delivery services), [`src/Umbraco.Cms.Api.Management/Controllers/Document`](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers/Document) (Content editing), [`src/Umbraco.Cms.Api.Delivery/Controllers/Media/QueryMediaApiController.cs`](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Media/QueryMediaApiController.cs) (Media queries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_delivery["Content delivery"]
  node_delivery_api["Delivery API<br/>[Controllers]"]
  node_content_query["Content queries"]
  node_media_query["Media queries"]
  node_delivery_services["Delivery services<br/>[Services]"]
  node_delivery_cache["Output caching<br/>[Caching]"]
  node_delivery_querying["Query options<br/>[Querying]"]
end

subgraph group_management["Content management"]
  node_management_api["Management API<br/>[Controllers]"]
  node_content_editing["Content editing<br/>[Document]"]
  node_schema_editing["Schema editing<br/>[DataType]"]
  node_management_search["Management search"]
  node_template_query["Template queries"]
  node_preview["Preview routes<br/>[PreviewRoutes.cs]"]
end

subgraph group_shared["Shared CMS core"]
  node_api_common["API common"]
  node_content_models["Content models<br/>[Content.cs]"]
  node_content_types["Content types<br/>[ContentType.cs]"]
  node_paged_models["Paged results<br/>[PagedModel.cs]"]
end

subgraph group_runtime["Runtime services"]
  node_published_content["Published content"]
  node_published_cache[("Published cache")]
  node_search_runtime["Search runtime<br/>[Search]"]
  node_log_queries[("Log query storage")]
end

node_caller(("API client"))

node_caller -->|"queries content"| node_content_query
node_caller -.->|"queries media"| node_media_query
node_caller -.->|"manages CMS"| node_management_api
node_caller -.->|"opens preview"| node_preview
node_delivery_api -.->|"routes requests"| node_content_query
node_content_query -.->|"executes query"| node_delivery_services
node_content_query -->|"loads items"| node_published_cache
node_content_query -->|"returns page"| node_paged_models
node_media_query -.->|"queries media"| node_delivery_services
node_delivery_services -.->|"applies options"| node_delivery_querying
node_content_editing -.->|"manages content"| node_content_models
node_content_editing -.->|"uses schemas"| node_content_types
node_management_search -->|"executes search"| node_search_runtime
node_template_query -->|"queries published items"| node_published_content
node_preview -->|"maps hub route"| node_management_api
node_published_cache -.->|"provides items"| node_published_content
node_api_common -->|"defines API pages"| node_paged_models

click node_delivery_api "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Controllers"
click node_content_query "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs"
click node_media_query "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Media/QueryMediaApiController.cs"
click node_delivery_services "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Services"
click node_delivery_cache "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Caching"
click node_delivery_querying "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Querying"
click node_management_api "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers"
click node_content_editing "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers/Document"
click node_schema_editing "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers/DataType"
click node_management_search "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Controllers/Searcher/QuerySearcherController.cs"
click node_template_query "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Controllers/Template/Query/ExecuteTemplateQueryController.cs"
click node_preview "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Routing/PreviewRoutes.cs"
click node_api_common "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Common"
click node_content_models "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/Content.cs"
click node_content_types "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/ContentType.cs"
click node_paged_models "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/PagedModel.cs"
click node_published_content "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.PublishedCache.HybridCache/PublishedContent.cs"
click node_published_cache "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.PublishedCache.HybridCache"
click node_search_runtime "https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Infrastructure/Search"
click node_log_queries "https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Infrastructure/Persistence/Repositories/Implement/LogViewerQueryRepository.cs"

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_delivery_api,node_content_query,node_media_query,node_delivery_services,node_delivery_cache,node_delivery_querying,node_caller toneBlue
class node_management_api,node_content_editing,node_schema_editing,node_management_search,node_template_query,node_preview toneAmber
class node_api_common,node_content_models,node_content_types,node_paged_models toneMint
class node_published_content,node_published_cache,node_search_runtime,node_log_queries toneRose
```

## Components

### Content delivery

- [Delivery API](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Controllers): `src/Umbraco.Cms.Api.Delivery/Controllers`
- [Content queries](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs): `src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`
- [Media queries](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Delivery/Controllers/Media/QueryMediaApiController.cs): `src/Umbraco.Cms.Api.Delivery/Controllers/Media/QueryMediaApiController.cs`
- [Delivery services](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Services): `src/Umbraco.Cms.Api.Delivery/Services`
- [Output caching](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Caching): `src/Umbraco.Cms.Api.Delivery/Caching`
- [Query options](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Delivery/Querying): `src/Umbraco.Cms.Api.Delivery/Querying`

### Content management

- [Management API](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers): `src/Umbraco.Cms.Api.Management/Controllers`
- [Content editing](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers/Document): `src/Umbraco.Cms.Api.Management/Controllers/Document`
- [Schema editing](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Management/Controllers/DataType): `src/Umbraco.Cms.Api.Management/Controllers/DataType`
- [Management search](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Controllers/Searcher/QuerySearcherController.cs): `src/Umbraco.Cms.Api.Management/Controllers/Searcher/QuerySearcherController.cs`
- [Template queries](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Controllers/Template/Query/ExecuteTemplateQueryController.cs): `src/Umbraco.Cms.Api.Management/Controllers/Template/Query/ExecuteTemplateQueryController.cs`
- [Preview routes](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Cms.Api.Management/Routing/PreviewRoutes.cs): `src/Umbraco.Cms.Api.Management/Routing/PreviewRoutes.cs`

### Shared CMS core

- [API common](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Cms.Api.Common): `src/Umbraco.Cms.Api.Common`
- [Content models](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/Content.cs): `src/Umbraco.Core/Models/Content.cs`
- [Content types](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/ContentType.cs): `src/Umbraco.Core/Models/ContentType.cs`
- [Paged results](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Core/Models/PagedModel.cs): `src/Umbraco.Core/Models/PagedModel.cs`

### Runtime services

- [Published content](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.PublishedCache.HybridCache/PublishedContent.cs): `src/Umbraco.PublishedCache.HybridCache/PublishedContent.cs`
- [Published cache](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.PublishedCache.HybridCache): `src/Umbraco.PublishedCache.HybridCache`
- [Search runtime](https://github.com/umbraco/umbraco-cms/tree/main/src/Umbraco.Infrastructure/Search): `src/Umbraco.Infrastructure/Search`
- [Log query storage](https://github.com/umbraco/umbraco-cms/blob/main/src/Umbraco.Infrastructure/Persistence/Repositories/Implement/LogViewerQueryRepository.cs): `src/Umbraco.Infrastructure/Persistence/Repositories/Implement/LogViewerQueryRepository.cs`

### Other components

- **API client**

## Connections

- API client → Content queries: queries content (evidence: `src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`)
- API client → Media queries: queries media
- API client → Management API: manages CMS
- API client → Preview routes: opens preview
- Delivery API → Content queries: routes requests (evidence: `src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`)
- Content queries → Delivery services: executes query
- Content queries → Published cache: loads items (evidence: `src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`)
- Content queries → Paged results: returns page (evidence: `src/Umbraco.Cms.Api.Delivery/Controllers/Content/QueryContentApiController.cs`)
- Media queries → Delivery services: queries media
- Delivery services → Query options: applies options
- Content editing → Content models: manages content
- Content editing → Content types: uses schemas
- Management search → Search runtime: executes search (evidence: `src/Umbraco.Cms.Api.Management/Controllers/Searcher/QuerySearcherController.cs`)
- Template queries → Published content: queries published items (evidence: `src/Umbraco.Cms.Api.Management/Controllers/Template/Query/ExecuteTemplateQueryController.cs`)
- Preview routes → Management API: maps hub route (evidence: `src/Umbraco.Cms.Api.Management/Routing/PreviewRoutes.cs`)
- Published cache → Published content: provides items (evidence: `src/Umbraco.PublishedCache.HybridCache/PublishedContent.cs`)
- API common → Paged results: defines API pages (evidence: `src/Umbraco.Cms.Api.Common/ViewModels/Pagination/PagedViewModel.cs`)
