# Breaking Change

> A change that makes code built on the old version stop working.

**Field:** Software Development  
**Category:** Product & Releases  
**Also known as:** Breaking Update, Incompatible Change, Backwards-Incompatible Change

## Think of it like

Think of it like moving the light switch to the other wall. Everyone who reaches for the old spot hits the wall.

## Definition

A breaking change is a change that makes code which used the old version stop working. Renaming a function, removing an option or changing what a reply looks like can all break things. The people affected must change their own code to update. Under semantic versioning, a breaking change needs a new major version. Good teams warn first, give a way to move over, and list it clearly.

## Example

Emma's API renames the field user_name to username. Every app that read the old name now shows a blank. She should have called it version 2.

## Why it matters

Others build on your code. An unwarned break can take down apps you have never heard of.

## Common mistake

Thinking a small rename is harmless. If anyone else's code uses the old name, it is a breaking change.

## Three principles

- **Old code stops working.** Users must change theirs.
- **Needs a major version.** Under semantic versioning.
- **Warn first.** And give a way over.

## Related terms

- [Backward Compatibility](https://learn.benibix.com/term/development/backward-compatibility)
- [Semantic Versioning (SemVer)](https://learn.benibix.com/term/development/semantic-versioning)
- [Deprecation](https://learn.benibix.com/term/development/deprecation)
- [API Versioning](https://learn.benibix.com/term/development/api-versioning)

---

Source: https://learn.benibix.com/term/development/breaking-change
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.
