# @polkadot/ui-settings

> Manages app settings

Latest version **3.16.7** (published 2026-03-26) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @polkadot/ui-settings
pnpm add @polkadot/ui-settings
yarn add @polkadot/ui-settings
bun add @polkadot/ui-settings
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.16.7 |
| Published | 2026-03-26 |
| First published | 2018-12-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18 |
| Dependencies | 5 |
| Unpacked size | 97.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 124 |
| Author | Jaco Greeff |
| Maintainers | jacogr, polkadotjs, paritytech-ci |

## Links

- npm: https://www.npmjs.com/package/@polkadot/ui-settings
- Repository: https://github.com/polkadot-js/ui
- Homepage: https://github.com/polkadot-js/ui/tree/master/packages/ui-settings#readme
- Issues: https://github.com/polkadot-js/ui/issues
- npm.io page: https://npm.io/package/@polkadot/ui-settings

## Dependencies (5)

- [store](https://npm.io/package/store.md) ^2.0.12
- [tslib](https://npm.io/package/tslib.md) ^2.8.1
- [eventemitter3](https://npm.io/package/eventemitter3.md) ^5.0.1
- [@polkadot/util](https://npm.io/package/@polkadot/util.md) ^14.0.3
- [@polkadot/networks](https://npm.io/package/@polkadot/networks.md) ^14.0.3

## Recent versions

- 3.16.7 (latest) — 2026-03-26
- 2.5.2-0 (beta) — 2022-06-21
- 3.16.4 — 2025-11-25
- 3.16.3 — 2025-11-12
- 3.16.2 — 2025-10-22
- 3.16.1 — 2025-08-27
- 3.15.4 — 2025-08-13
- 3.15.3 — 2025-07-30
- 3.15.2 — 2025-07-02
- 3.15.1 — 2025-06-18
- 3.14.1 — 2025-05-23
- 3.13.1 — 2025-04-16
- 3.12.2 — 2025-02-18
- 3.12.1 — 2025-01-08
- 3.11.3 — 2024-11-12
- … 684 more at https://npm.io/package/@polkadot/ui-settings/versions

## README

# @polkadot/ui-settings

Manages app settings including endpoints, themes and prefixes

## Usage Examples

User preferences are set as a settings object in the browser's local storage.

```js
import settings from '@polkadot/ui-settings';

render () {
  // get api endpoint for the selected chain
  const WS_URL = settings.apiUrl();

  // get the selected il8n language
  const language = settings.il8nLang();

  // get all available il8n languages
  const languages = settings.availableLanguages();

  // update settings
  const updatedSettings = {
    ...settings,
    i18nLang: 'Arabic'
  }
  settings.set(updatedSettings);

  // NOTE: API currently does not handle hot reconnecting properly,
  so you need to manually reload the page after updating settings.
  window.location.reload();
}
```

## Used by

Apps that currently use the settings package

* [polkadot-js/apps](https://www.github.com/polkadot-js/apps)
* [paritytech/substrate-light-ui](https://github.com/paritytech/substrate-light-ui)

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