C4 model elements

Understand C4 model people, software systems, containers, and components, including their hierarchy, syntax, metadata, and examples.

Acefy Architecture Language (AAL) · AAL C4 0.2 · Level-aware semantics

On this page
Independent diagram copies
Copy to Cloud or Local creates an independent diagram in the chosen destination and leaves the original open. Future changes do not sync. Duplicate keeps the same project and location. Cloud folder and diagram counts are unlimited; document size and write-rate limits still apply.
Projects panel with a folder expanded to show its diagrams and Markdown documents
Expand a folder to browse its diagrams and Markdown documents. Click an item to open it.

Person

A human actor who interacts with the system. People exist at the top level and appear in context views.

Syntax: person <id> "<name>"
Example
person Customer "Customer"
description
tags
color
icon
Parent: none (top-level)
Can contain: nothing

Software System

A high-level software system or application. Systems contain containers. External systems may carry a System-level semantic type (e.g. crm, identity, coresystem).

Syntax: system <id> "<name>" [external <semanticType>]
Example
system Okta "Okta" external identity
description
technology
owner
tags
external
color
icon
Parent: none (top-level)
Can contain: containers

Container

A deployable unit within a system — an app, API, database, or service. Containers belong to systems and can contain components. May carry a Container-level semantic type.

Syntax: container <id> "<name>" [<semanticType>]
Example
container API "Application API" api
description
technology
owner
tags
color
icon
Parent: system
Can contain: components

Component

A modular unit within a container — a controller, service, repository, adapter, or other architectural responsibility. Components belong to containers. May carry a Component-level semantic type.

Syntax: component <id> "<name>" [<semanticType>]
Example
component PolicyRepository "Policy Repository" repository
description
technology
owner
tags
color
icon
Parent: container
Can contain: nothing