C4 model

From Wikipedia, the free encyclopedia
Abstractions of the C4 model: A software system is made up of one or more containers (web applications, databases, etc), each of which contains one or more components, which in turn are implemented by one or more code elements (classes, interfaces, objects, functions, etc)

The C4 model is a lean graphical notation technique for modeling the architecture of software systems.[1][2] It is based on a structural decomposition (a hierarchical tree structure) of a system into containers and components and relies on existing modelling techniques such as Unified Modeling Language (UML) or entity–relationship diagrams (ERDs) for the more detailed decomposition of the architectural building blocks.


The C4 model was created by the software architect Simon Brown between 2006 and 2011 on the roots of Unified Modelling Language (UML) and the 4+1 architectural view model. The launch of an official website under a Creative Commons license[3] and an article[4] published in 2018 popularised the emerging technique.[1]


The C4 model documents the architecture of a software system, by showing multiple points of view[5] that explain the decomposition of a system into containers and components, the relationship between these elements, and, where appropriate, the relation with its users.[3]

The viewpoints are organized according to their hierarchical level:[2][3]

  • Context diagrams (level 1): show the system in scope and its relationship with users and other systems;
  • Container diagrams (level 2): decompose a system into interrelated containers. A container represents an application or a data store;
  • Component diagrams (level 3): decompose containers into interrelated components, and relate the components to other containers or other systems;
  • Code diagrams (level 4): provide additional details about the design of the architectural elements that can be mapped to code. The C4 model relies at this level on existing notations such as Unified Modelling Language (UML), Entity Relation Diagrams (ERD) or diagrams generated by Integrated Development Environments (IDE).

For level 1 to 3, the C4 model uses 5 basic diagramming elements: persons, software systems, containers, components and relationships. The technique is not prescriptive for the layout, shape, colour and style of these elements. Instead, the C4 model recommends using simple diagrams based on nested boxes in order to facilitate interactive collaborative drawing. The technique also promotes good modelling practices such as providing a title and legend on every diagram, and clear unambiguous labelling in order to facilitate the understanding by the intended audience.

The C4 model facilitates collaborative visual architecting and evolutionary architecture in the context of agile teams where more formal documentation methods and up-front architectural design are not desired.[6]

See also[edit]


  1. ^ a b Richards, Mark; Ford, Neal (2019). Fundamentals of software architecture: an engineering approach. O'REILLY MEDIA. p. 293. ISBN 978-1-4920-4342-3. OCLC 1138515057. some standard are emerging for diagramming software architecture (such as software architect Simon Brown's C4 model or The Open Group Archimate standard)
  2. ^ a b Enríquez, René (2018). Software Architecture with Spring 5. 0 : Design and Architect Highly Scalable, Robust, and High-Performance Java Applications. Salazar, Alberto. Packt Publishing Ltd. pp. 41–44. ISBN 978-1-78899-673-0. OCLC 1053798657.
  3. ^ a b c Brown, Simon. "The C4 model for visualising software architecture". c4model.com (Official site of the modelling technique). Archived from the original on 2010-02-25. Retrieved 2020-08-22.
  4. ^ Brown, Simon (2018-06-25). "The C4 Model for Software Architecture". InfoQ. Archived from the original on 2018-12-12. Retrieved 2020-08-22.
  5. ^ Keeling, Michael. Design it! : from programmer to software architect. Raleigh, North Carolina. ISBN 978-1-68050-345-6. OCLC 1024312521.
  6. ^ "The Conflict Between Agile and Architecture: Myth or Reality?". resources.sei.cmu.edu. SATURN 2013 conference. Software Engineering Institute of Carnegie Mellon University. Archived from the original on 2021-04-19. Retrieved 2020-08-22.

External links[edit]