# wordpress-icon-picker

> Icon Picker for WordPress, Gutenberg, Theme development. Dashicon and FontAwesome icon support

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

## Install

```sh
npm install wordpress-icon-picker
pnpm add wordpress-icon-picker
yarn add wordpress-icon-picker
bun add wordpress-icon-picker
```

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.2.6 |
| Published | 2026-06-09 |
| First published | 2023-07-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 60.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | MD Jamil Uddin |
| Maintainers | jamilbd07 |
| Keywords | wordpress, icon, picker, gutenberg, icon, picker, icon, picker, react, icon, picker, fontawesome, icon, picker |

## Links

- npm: https://www.npmjs.com/package/wordpress-icon-picker
- Repository: https://github.com/jamilbd07/WordPress-Icon-Picker
- Homepage: https://github.com/jamilbd07/WordPress-Icon-Picker#readme
- Issues: https://github.com/jamilbd07/WordPress-Icon-Picker/issues
- npm.io page: https://npm.io/package/wordpress-icon-picker

## Dependencies (3)

- [@wordpress/i18n](https://npm.io/package/@wordpress/i18n.md) ^4.46.0
- [@wordpress/element](https://npm.io/package/@wordpress/element.md) ^5.23.0
- [@wordpress/components](https://npm.io/package/@wordpress/components.md) ^25.12.0

## Alternatives

- [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) — 2.2M weekly downloads
- [roboto-fontface](https://npm.io/package/roboto-fontface.md) — 196.0K weekly downloads
- [@react-native-vector-icons/common](https://npm.io/package/@react-native-vector-icons/common.md) — 150.4K weekly downloads
- [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads
- [@react-md/material-icons](https://npm.io/package/@react-md/material-icons.md) — 1.6K weekly downloads

## Recent versions

- 1.2.6 (latest) — 2026-06-09
- 1.2.5 — 2026-06-09
- 1.2.4 — 2026-05-12
- 1.2.3 — 2024-08-18
- 1.2.2 — 2024-01-22
- 1.2.1 — 2024-01-10
- 1.2.0 — 2023-12-27
- 1.1.1 — 2023-10-23
- 1.1.0 — 2023-10-12
- 1.0.8 — 2023-08-29
- 1.0.5 — 2023-08-25
- 1.0.3 — 2023-08-18
- 1.0.2 — 2023-07-09
- 1.0.1 — 2023-07-09
- 1.0.0 — 2023-07-08

## README

# WordPress Icon Picker

A simple and reusable Icon Picker component for WordPress & Gutenberg

## Installation

The package can be installed via [npm](https://github.com/npm/cli):

```
npm install wordpress-icon-picker --save
```

Or via [yarn](https://github.com/yarnpkg/yarn):

```
yarn add wordpress-icon-picker
```

You’ll need to install React inside your WordPress environment. In your react component where you want to show the iconpicker, add the code like below: 

```js
import { useState } from "@wordpress/element";
import {IconPicker} from "wordpress-icon-picker";
import "wordpress-icon-picker/dist/style.css"

const Example = () => {
  const [icon, setIcon] = useState('');
  return (
    <IconPicker
		    value={icon}
        icons = {IconList} //optional -- Array
        onChange={(value) =>
            setIcon(value)
        }
        title={"Select Icon"} //optional
        showHeading={true} //optional
        disableDashicon = {false} //optional
        disableFontAwesome = {false} //optional
    />
  );
};
```

To display Icon, add the code like below in your component.
```js
import {DisplayIcon} from "wordpress-icon-picker";

const Example = () => {
  return (
    <DisplayIcon icon={icon} />
  );
};
```

#### To display icons, please ensure that FontAwesome 6.5 or a higher version is loaded.

## License

Copyright (c) 2023 individual contributors. Licensed under MIT license, see [LICENSE](LICENSE) for the full license.

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