# @wordpress/interactivity

> Package that provides a standard and simple way to handle the frontend interactivity of Gutenberg blocks.

Latest version **6.55.0** (published 2026-09-10) · GPL-2.0-or-later license · 0 weekly downloads

## Install

```sh
npm install @wordpress/interactivity
pnpm add @wordpress/interactivity
yarn add @wordpress/interactivity
bun add @wordpress/interactivity
```

## Health

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

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 6.55.0 |
| Published | 2026-09-10 |
| First published | 2023-07-05 |
| Weekly downloads | 0 |
| License | GPL-2.0-or-later |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.12.0 |
| Dependencies | 3 |
| Unpacked size | 565.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 11754 |
| Author | The WordPress Contributors |
| Maintainers | garypendergast, adamsilverstein, gziolo, ntwb, riad, noisysocks, kadamwhite, gutenbergplugin, jorgefilipecosta, ellatrix, iandunn206, whyisjake, ockham, sirreal, nosolosw, wpisabel, ntsekouras, nerrad, desrosj, talldanwp, peterwilsoncc, ryanwelcher, mamaduka, aduth, johnbillion |
| Keywords | wordpress, gutenberg, interactivity |

## Links

- npm: https://www.npmjs.com/package/@wordpress/interactivity
- Repository: https://github.com/WordPress/gutenberg
- Homepage: https://github.com/WordPress/gutenberg/tree/HEAD/packages/interactivity/README.md
- Issues: https://github.com/WordPress/gutenberg/labels/%5BFeature%5D%20Interactivity%20API
- npm.io page: https://npm.io/package/@wordpress/interactivity

## Dependencies (3)

- [preact](https://npm.io/package/preact.md) ^10.29.1
- [@preact/signals](https://npm.io/package/@preact/signals.md) ^1.3.0
- [@preact/signals-core](https://npm.io/package/@preact/signals-core.md) ^1.7.0

## Recent versions

- 6.55.0 (latest) — 2026-09-10
- 6.54.1-next.v.202609031004.0 (next) — 2026-09-03
- 6.40.1 (wp-7.0) — 2026-06-30
- 6.33.3 (wp-6.9) — 2026-01-29
- 6.19.1 (wp-6.8) — 2025-03-10
- 6.8.6 (wp-6.7) — 2025-02-04
- 6.0.2 (wp-6.6) — 2024-06-25
- 5.0.6 (wp-6.5) — 2024-05-02
- 2.3.13 (wp-6.4) — 2023-11-13
- 2.1.1 (wp-6.3) — 2023-08-20
- 6.54.1-next.v.202608281122.0 — 2026-08-28
- 6.54.0 — 2026-08-26
- 6.53.0 — 2026-08-12
- 6.52.0 — 2026-07-29
- 6.51.0 — 2026-07-14
- … 153 more at https://npm.io/package/@wordpress/interactivity/versions

## README

# `@wordpress/interactivity`

The package `@wordpress/interactivity` contains the logic that enables the Interactivity API which was [introduced in WordPress Core in v6.5](https://make.wordpress.org/core/2024/02/19/merge-announcement-interactivity-api/). This means this package is already bundled in Core in any version of WordPress higher than v6.5.

<div class="callout callout-info">
    Check the <a href="https://developer.wordpress.org/block-editor/reference-guides/interactivity-api/">Interactivity API Reference docs in the Block Editor handbook</a> to learn more about the Interactivity API.
</div>

## Installation

Install the Interactivity API using the command:

```bash
npm install @wordpress/interactivity --save
```

This step is only required if you use the Interactivity API outside WordPress.

Within WordPress, the package is already bundled in Core. To ensure it's loaded, add `@wordpress/interactivity` to the dependency array of the script module. This process is often done automatically with tools like [`wp-scripts`](https://developer.wordpress.org/block-editor/getting-started/devenv/get-started-with-wp-scripts/).

Furthermore, this package assumes your code will run in an **ES2015+** environment. If you're using an environment with limited or no support for such language features and APIs, you should include the polyfill shipped in [`@wordpress/babel-preset-default`](https://github.com/WordPress/gutenberg/tree/HEAD/packages/babel-preset-default#polyfill) in your code.

## License

Interactivity API proposal, as part of Gutenberg and the WordPress project is free software, and is released under the terms of the GNU General Public License version 2 or (at your option) any later version. See [LICENSE.md](https://github.com/WordPress/gutenberg/blob/trunk/LICENSE.md) for complete license.

<br/><br/><p align="center"><img src="https://s.w.org/style/images/codeispoetry.png?1" alt="Code is Poetry." /></p>

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