# env-paths changelog

> Returns the OS-correct paths for a program's config, data, cache and logs.

- Vendor: Sindre Sorhus
- Category: Developer Tools
- Official site: https://github.com/sindresorhus/env-paths
- Tracked by: What's New (https://whatsnew.fyi/product/env-paths)
- Harvested from: GitHub (sindresorhus/env-paths)
- Entries below: 6 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v4.0.0

- Date: 2026-01-24
- Version: v4.0.0
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v4.0.0
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v4.0.0

- **changed** — Require Node.js 20

###### Breaking

- Require Node.js 20  612c498

---

https://github.com/sindresorhus/env-paths/compare/v3.0.0...v4.0.0

### v3.0.0

- Date: 2021-08-27
- Version: v3.0.0
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v3.0.0
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v3.0.0

- **changed** — Require Node.js 12.20 or later
- **changed** — This package is now pure ESM

###### Breaking

- Require Node.js 12.20  995e663
- This package is now pure ESM. Please [read this](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).

https://github.com/sindresorhus/env-paths/compare/v2.2.1...v3.0.0

### v2.2.1

- Date: 2021-03-08
- Version: v2.2.1
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v2.2.1
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v2.2.1

- **added** — Add example locations to docs

- Add example locations to docs (#16)  463aace

https://github.com/sindresorhus/env-paths/compare/v2.2.0...v2.2.1

### v2.2.0

- Date: 2019-04-01
- Version: v2.2.0
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v2.2.0
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v2.2.0

- **changed** — Refactor TypeScript definition to CommonJS compatible export

- Refactor TypeScript definition to CommonJS compatible export (#12)  dacf4e9

https://github.com/sindresorhus/env-paths/compare/v2.1.0...v2.2.0

### v2.1.0

- Date: 2019-03-04
- Version: v2.1.0
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v2.1.0
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v2.1.0

- **added** — Add TypeScript definition

- Add TypeScript definition (#11)  949cd22

https://github.com/sindresorhus/env-paths/compare/v2.0.0...v2.1.0

### v2.0.0

- Date: 2018-11-05
- Version: v2.0.0
- Original notes: https://github.com/sindresorhus/env-paths/releases/tag/v2.0.0
- Permalink: https://whatsnew.fyi/product/env-paths/releases/v2.0.0

- **changed** — Minimum Node.js version is now 6
- **changed** — The .config property now uses %APPDATA% instead of %LOCALAPPDATA% on Windows

Breaking:
- Requires Node.js 6.
- The `.config` property now uses `%APPDATA%` instead of `%LOCALAPPDATA%` on Windows, which is [more correct](https://github.com/sindresorhus/env-paths/issues/8). If you already use this property, you'll either have to move your files over to the new location or stay at version 1.