# Immer

JavaScript package that allows code to work with immutable state in a more convenient way.


Source: https://findsoftware.frbit.cloud/immer/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://immerjs.github.io/immer/
- repository: https://github.com/immerjs/immer
- docs: https://immerjs.github.io/immer/

### Identity

- status: active
- maintainer: Michel Weststrate
- maintainerType: individual
- parent: unknown
- firstRelease: 2016
- hqCountry: unknown

### Kind

- category: library
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm install immer or yarn add immer, deno install immer, script tag from the unpkg or jsDelivr CDN

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 11
- latestReleaseDate: 2026-11-10

### Adoption

- githubStargazers: 29003
- packagistDownloads: not applicable
- npmWeeklyDownloads: 92536667
- contributors: 222
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 1478225
- dependentPackages: 5437

### Sources

- urls: https://immerjs.github.io/immer/ (read 2026-11-16)
- urls: https://api.github.com/repos/immerjs/immer (read 2026-11-16)
- urls: https://immerjs.github.io/immer/ (read 2026-11-16)
- maintainer: https://github.com/immerjs/immer/blob/main/LICENSE (read 2026-11-16)
- maintainerType: https://github.com/immerjs/immer/blob/main/LICENSE (read 2026-11-16)
- language: https://api.github.com/repos/immerjs/immer (read 2026-11-16)
- category: https://immerjs.github.io/immer/ (read 2026-11-16)
- license: https://github.com/immerjs/immer/blob/main/LICENSE (read 2026-11-16)
- licenseModel: https://github.com/immerjs/immer/blob/main/LICENSE (read 2026-11-16)
- installMethod: https://immerjs.github.io/immer/installation/ (read 2026-11-16)
- installMethod: https://immerjs.github.io/immer/installation/ (read 2026-11-16)
- installMethod: https://immerjs.github.io/immer/installation/ (read 2026-11-16)
- currentMajor: https://api.github.com/repos/immerjs/immer/releases/latest (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/immerjs/immer/releases/latest (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/immer (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/immer (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/immerjs/immer (read 2026-11-16)
- contributors: https://api.github.com/repos/immerjs/immer/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/immer (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/immer (read 2026-11-16)

## Notes

Immer lets code change a draft of plain JavaScript objects, arrays, Sets and Maps, and then produces the next immutable state from those changes, with structural sharing and object freezing. The documentation says it can be used wherever immutable data structures are needed, such as React state, Redux reducers or configuration management, and it supports JSON patches for communicating changes.

## Worth knowing

Support for Map and Set, JSON patches and an array-method optimization is opt-in: each is enabled once by a function call at application start. Immer relies on Proxy and cannot be used in engines without it.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
