# @wordpress/notices

> State management for notices.

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

## Install

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

## 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 | 5.55.0 |
| Published | 2026-09-10 |
| First published | 2018-10-29 |
| Weekly downloads | 0 |
| License | GPL-2.0-or-later |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.12.0 |
| Dependencies | 4 |
| Unpacked size | 184 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, notices |

## Links

- npm: https://www.npmjs.com/package/@wordpress/notices
- Repository: https://github.com/WordPress/gutenberg
- Homepage: https://github.com/WordPress/gutenberg/tree/HEAD/packages/notices/README.md
- Issues: https://github.com/WordPress/gutenberg/issues
- npm.io page: https://npm.io/package/@wordpress/notices

## Dependencies (4)

- [clsx](https://npm.io/package/clsx.md) ^2.1.1
- [@wordpress/a11y](https://npm.io/package/@wordpress/a11y.md) ^4.55.0
- [@wordpress/data](https://npm.io/package/@wordpress/data.md) ^10.55.0
- [@wordpress/components](https://npm.io/package/@wordpress/components.md) ^40.1.0

## Recent versions

- 5.55.0 (latest) — 2026-09-10
- 5.54.1-next.v.202609031004.0 (next) — 2026-09-03
- 5.40.1 (wp-7.0) — 2026-06-30
- 5.33.1 (wp-6.9) — 2025-10-28
- 5.19.2 (wp-6.8) — 2025-07-08
- 5.8.4 (wp-6.7) — 2025-02-04
- 5.0.2 (wp-6.6) — 2024-06-18
- 3.6.2 (wp-6.0) — 2024-04-10
- 4.19.1 (wp-6.5) — 2024-02-20
- 4.10.13 (wp-6.4) — 2023-11-13
- 4.3.6 (wp-6.3) — 2023-10-12
- 3.26.4 (wp-6.2) — 2023-10-12
- 3.17.3 (wp-6.1) — 2022-10-04
- 3.2.8 (wp-5.9) — 2021-12-21
- 2.12.9 (wp-5.7) — 2021-09-08
- … 285 more at https://npm.io/package/@wordpress/notices/versions

## README

# Notices

State management and UI components for notices.

## Installation

Install the module

```bash
npm install @wordpress/notices
```

_This package assumes that your code will run in an **ES2015+** environment. If you're using an environment that has 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._

## Usage

When imported, the notices module registers a data store on the `core/notices` namespace. In WordPress, this is accessed from `wp.data.dispatch( 'core/notices' )`.

For more information about consuming from a data store, refer to [the `@wordpress/data` documentation on _Data Access and Manipulation_](https://github.com/WordPress/gutenberg/tree/HEAD/packages/data/README.md#data-access-and-manipulation).

For a full list of actions and selectors available in the `core/notices` namespace, refer to the [_Notices Data_ Handbook page](https://github.com/WordPress/gutenberg/tree/HEAD/docs/reference-guides/data/data-core-notices.md).

## Components

The package also exports ready-to-use notice UI components powered by the `core/notices` store.

### `InlineNotices`

Renders notice lists for notices with type `default`:

-   non-dismissible notices in a pinned list.
-   dismissible notices in a removable list.

`children` are rendered inside the dismissible list.

_Props_

-   `children: ReactNode` (optional): Additional content rendered in the dismissible notice list.
-   `className: string` (optional): Extra class name added to the inline notices wrapper.
-   `pinnedNoticesClassName: string` (optional): Extra class name added to the pinned list.
-   `dismissibleNoticesClassName: string` (optional): Extra class name added to the dismissible list.
-   `context: string` (optional): Notice context to read and remove notices from. Defaults to `default`.

### `SnackbarNotices`

Renders notices with type `snackbar` using `SnackbarList`.

-   It renders the last three snackbar notices.
-   Dismiss actions are wired to `removeNotice`.

_Props_

-   `className: string` (optional): Extra class name added to the snackbar list.
-   `context: string` (optional): Notice context to read and remove notices from. Defaults to `default`.

## Example

```jsx
import { useDispatch } from '@wordpress/data';
import {
	InlineNotices,
	SnackbarNotices,
	store as noticesStore,
} from '@wordpress/notices';

function AppNotices() {
	const { createSuccessNotice } = useDispatch( noticesStore );
	const noticeContext = 'my-plugin/screen';

	return (
		<>
			<button
				onClick={ () =>
					createSuccessNotice( 'Saved successfully.', {
						type: 'snackbar',
						context: noticeContext,
					} )
				}
			>
				Create snackbar notice
			</button>

			<InlineNotices
				pinnedNoticesClassName="my-plugin-notices__pinned"
				dismissibleNoticesClassName="my-plugin-notices__dismissible"
				context={ noticeContext }
			/>
			<SnackbarNotices
				className="my-plugin-notices__snackbar"
				context={ noticeContext }
			/>
		</>
	);
}
```

## 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).

<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/notices · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._