# Deprecation

> Marking a feature as on its way out. It still works for now.

**Field:** Software Development  
**Category:** Product & Releases  
**Also known as:** Deprecated, Deprecate, Deprecation Warning

## Think of it like

Think of it like a sign that says this road will close next year. You can still drive on it, but find another way.

## Definition

Deprecation is marking a feature as old and due to go, while it still works. Users see a warning in the docs or when they run their code. This gives them time to move to the new way. The feature is then removed in a later major version. Deprecating first turns a sudden break into a planned move.

## Example

Lucy's library marks an old function as deprecated in version 3.2. It prints a warning naming the new one, and she removes it in version 4.

## Why it matters

It gives everyone time to update calmly. Nobody finds out when their app breaks.

## Common mistake

Ignoring old-feature warnings in your own project. One day you update and the feature is gone.

## Three principles

- **Still works.** For now.
- **Warns users.** In docs and at run time.
- **Removed later.** In a major version.

## Related terms

- [Breaking Change](https://learn.benibix.com/term/development/breaking-change)
- [Backward Compatibility](https://learn.benibix.com/term/development/backward-compatibility)
- [Semantic Versioning (SemVer)](https://learn.benibix.com/term/development/semantic-versioning)
- [Changelog](https://learn.benibix.com/term/development/changelog)
- [End of Life (EOL)](https://learn.benibix.com/term/development/end-of-life)

## Told apart from

- [Deprecation vs End of Life](https://learn.benibix.com/compare/deprecation-vs-end-of-life): People think a deprecated feature has stopped working, and it has not. Deprecated means it still works, but you are told to stop using it because it will go away. End of life is later. It is the date when a version gets no more fixes at all, not even for safety holes.

---

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