# Unified Modeling Language (UML)

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

**Field:** Software Development  
**Category:** Architecture  
**Also known as:** UML, UML Diagram, UML Class Diagram

## Think of it like

It is like the signs on a map. Everyone knows a blue line means a river.

## Definition

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.

## Common mistake

Drawing every class in full detail. Big diagrams go out of date fast, so draw only what helps the talk you are having.

## Three principles

- **Structure diagrams.** What the parts are.
- **Behavior diagrams.** What happens, in order.
- **A shared standard.** Same signs for everyone.

## Related terms

- [Class](https://learn.benibix.com/term/development/class)
- [Object-Oriented Programming (OOP)](https://learn.benibix.com/term/development/object-oriented-programming)
- [Technical Design Document](https://learn.benibix.com/term/development/technical-design-document)
- [Architecture Decision Record (ADR)](https://learn.benibix.com/term/development/architecture-decision-record)
- [Entity-Relationship Diagram (ERD)](https://learn.benibix.com/term/data/entity-relationship-diagram)
- [Software Architecture](https://learn.benibix.com/term/development/software-architecture)

## Told apart from

- [C4 Model vs UML](https://learn.benibix.com/compare/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.

![Three papers side by side. The first, a design doc, has headings for problem, design, options turned down and open questions. The second, an architecture decision record numbered 7, has headings for context, decision and consequences. The third, a UML class diagram, shows two boxes, Order and Customer, joined by a line marked many to one.](https://learn.benibix.com/diagrams/dev6-architecture-docs.svg)

---

Source: https://learn.benibix.com/term/development/uml
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
