# @metamask/preferences-controller

> Manages user-configurable settings for MetaMask

Latest version **24.0.0** (published 2026-09-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install @metamask/preferences-controller
pnpm add @metamask/preferences-controller
yarn add @metamask/preferences-controller
bun add @metamask/preferences-controller
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 24.0.0 |
| Published | 2026-09-09 |
| First published | 2022-11-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | ^22.14.0 \|\| ^24 |
| Dependencies | 2 |
| Unpacked size | 111 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 413 |
| Maintainers | frederikbolding, metamaskbot, gudahtt, mrten, mcmire, naugtur |
| Keywords | Ethereum, MetaMask |

## Links

- npm: https://www.npmjs.com/package/@metamask/preferences-controller
- Repository: https://github.com/MetaMask/core
- Homepage: https://github.com/MetaMask/core/tree/main/packages/preferences-controller#readme
- Issues: https://github.com/MetaMask/core/issues
- npm.io page: https://npm.io/package/@metamask/preferences-controller

## Dependencies (2)

- [@metamask/messenger](https://npm.io/package/@metamask/messenger.md) ^3.0.0
- [@metamask/base-controller](https://npm.io/package/@metamask/base-controller.md) ^10.0.0

## Recent versions

- 24.0.0 (latest) — 2026-09-09
- 23.1.0 — 2026-03-26
- 23.0.0 — 2026-03-09
- 22.1.0 — 2026-02-02
- 22.0.0 — 2025-11-20
- 21.0.0 — 2025-10-27
- 20.1.1 — 2025-10-24
- 20.1.0 — 2025-10-22
- 20.0.2 — 2025-10-09
- 20.0.1 — 2025-09-25
- 20.0.0 — 2025-09-24
- 19.0.0 — 2025-08-20
- 18.4.1 — 2025-07-03
- 18.4.0 — 2025-06-27
- 18.3.0 — 2025-06-26
- … 40 more at https://npm.io/package/@metamask/preferences-controller/versions

## README

# `@metamask/preferences-controller`

Manages user-configurable settings for MetaMask.

## Installation

`yarn add @metamask/preferences-controller`

or

`npm install @metamask/preferences-controller`

## Contributing

This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/core#readme).

---
_Source: https://npm.io/package/@metamask/preferences-controller · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._