Title: @wordpress/react-inert-value
Published: October 1, 2026

---

# @wordpress/react-inert-value

## In this article

 * [Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#installation)
 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#usage)
    - [inertValue](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#inertvalue)
 * [API](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#api)
    - [inertValue](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#inertvalue-2)
 * [Contributing to this package](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#contributing-to-this-package)

[ Back to top](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#wp--skip-link--target)

Return a React `inert` prop value that works under both React 18 and React 19.

React 19 treats `inert` as a boolean attribute. React 18 does not know about `inert`
and ignores `inert={ true }`, so the prop has to be the string `'true'` instead.
This package returns the value that the running React version will render as the`
inert` HTML attribute.

## 󠀁[Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#installation)󠁿

Install the module

    ```bash
    npm install @wordpress/react-inert-value --save
    ```

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#usage)󠁿

### 󠀁[inertValue](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#inertvalue)󠁿

    ```javascript
    import { inertValue } from '@wordpress/react-inert-value';

    <div inert={ inertValue( true ) } />;
    ```

## 󠀁[API](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#api)󠁿

### 󠀁[inertValue](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#inertvalue-2)󠁿

Returns a value for the `inert` prop that the running version of React renders as
the `inert` HTML attribute.

React 19 handles `inert` as a boolean attribute, while React 18 knows nothing about`
inert` and ignores `inert={ true }`, so it has to be given the string `'true'` instead.

The return type describes what React 19 types accept. React 18 doesn’t support `
inert` HTML attribute at all, so a TypeScript call site still needs a `@ts-expect-
error` annotation.

Inspired by the helper of the same name in the Base UI library.

_Parameters_

 * _value_ `boolean`: Boolean value for the `inert` prop.

_Returns_

 * `boolean | undefined`: The actual value to pass to the `inert` prop.

## 󠀁[Contributing to this package](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-inert-value/?output_format=md#contributing-to-this-package)󠁿

This is an individual package that’s part of the Gutenberg project. The project 
is organized as a monorepo. It’s made up of multiple self-contained software packages,
each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/)
and used by [WordPress](https://make.wordpress.org/core/) as well as other software
projects.

To find out more about contributing to this package or Gutenberg as a whole, please
read the project’s main [contributor guide](https://github.com/WordPress/gutenberg/tree/HEAD/CONTRIBUTING.md).

First published

October 1, 2026

Last updated

October 1, 2026

Edit article

[ Improve it on GitHub: @wordpress/react-inert-value ](https://github.com/WordPress/gutenberg/edit/trunk/packages/react-inert-value/README.md)

[  Previous: @wordpress/react-i18n](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-i18n/)

[  Next: @wordpress/readable-js-assets-webpack-plugin](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/)