# Changelog

> A file that lists what changed in each release. The newest is at the top.

**Field:** Software Development  
**Category:** Product & Releases  
**Also known as:** Change Log, CHANGELOG.md, Release Notes

## Think of it like

Think of it like a diary for your project. Each entry says what changed on that day.

## Definition

A changelog is a file that lists what changed in each release, newest first. Each version gets its own heading, with its number and date. Under it, changes are grouped, often as Added, Changed, Fixed and Removed. It is written for people, not machines, so it skips tiny details. Users read it to decide whether an update is safe or worth it.

## Example

Lucy wants to update a package from 3.1 to 3.4. She reads its changelog, sees one removed option she uses, and updates her code first.

## Example code

```markdown
## 2.4.0 - 2026-11-02

### Added
- Dark mode

### Fixed
- Login button on small screens
```

One version, its date, and what was added and fixed.

## Why it matters

Without one, users must read every commit to learn what an update does. Most will not, and they get surprised.

## Common mistake

Pasting the raw commit log as the changelog. It is long, unclear and hides the changes users care about.

## Three principles

- **One heading per version.** Number and date.
- **Grouped changes.** Added, changed, fixed.
- **Written for people.** Not a commit dump.

## Related terms

- [Release (Software)](https://learn.benibix.com/term/development/release)
- [Semantic Versioning (SemVer)](https://learn.benibix.com/term/development/semantic-versioning)
- [Software Documentation](https://learn.benibix.com/term/development/documentation)
- [Breaking Change](https://learn.benibix.com/term/development/breaking-change)

---

Source: https://learn.benibix.com/term/development/changelog
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-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
