Skip to content
BENIBIX Learn

C4 Model vs UML

People think the C4 model is a kind of UML, and it is not. UML is a set of symbols with strict rules, and it has many kinds of diagram. C4 is a set of four zoom levels, from the whole system down to the code. It asks for no special symbols. Many teams draw C4 maps with plain boxes and arrows, and use UML only for the code level.

Development🏗️ Architecture

C4 Model

Four zoom levels for drawing software. Start with the big map and end at the code.

The C4 model is a way to draw software at four levels of zoom. The first level, system context, shows your system, the people who use it and the other systems it talks to. The second, containers, shows the apps and data stores inside it. The third, components, opens one container to show its main parts. The fourth, code, shows classes and is rarely drawn. Simon Brown made it, and it works with any drawing tool.

Example
Emma joins a team that runs an online shop. Its context diagram shows shoppers, the shop and the payment service. The container diagram then shows the web app, the API and the database.
Why it matters
Each reader gets the level they need. A manager reads the first map, and a new developer zooms in to the third.
Full entry
Development🏗️ Architecture

Unified Modeling Language (UML)

A set of standard drawings. They show how code is built and how it acts.

The Unified Modeling Language is a standard set of drawings for showing how software is built and how it acts. A class diagram shows classes as boxes, with lines for how they link. A sequence diagram shows messages passing between parts over time. It is a standard from the Object Management Group. Its latest version, 2.5.1, came out in December 2017.

Example
Lucy draws a sequence diagram for checkout. It shows the app, the payment service and the bank. Every message between them is shown in order.
Why it matters
A shared picture language means a diagram says the same thing to every reader. Teams can talk about a design before they build it.
Full entry

In one line

C4 Model
Four zoom levels for drawing software. Start with the big map and end at the code.
Unified Modeling Language (UML)
A set of standard drawings. They show how code is built and how it acts.