A lightweight icon ecosystem for WordPress, powered by Iconify.

Subtle Icons is a bloat-free, lightweight plugin that brings thousands of icons directly into the WordPress block editor and Advanced Custom Fields (ACF). Search and insert icons from Lucide, Material, Heroicons, and dozens of other icon libraries without leaving the editor — or upload your own SVGs.

• Icon Block: A standalone icon block with sizing, thickness, and color controls.
• Icon + Text Block: Pair an icon with text for notices, callouts, and feature highlights.
• Icon List Block: Build beautiful, responsive lists with custom leading icons.
• Icon Button Block: Prompt visitors to take action with a native-feeling button block supporting leading and trailing icons.
• ACF Field Integration: A custom Icon Picker field type for Advanced Custom Fields.
• Iconify Integration: Powered by the massive open-source Iconify ecosystem.

• WordPress 6.5+
• PHP 7.4+
• Node.js (for development)

npm install

Build for production:

npm run build

Start the development watcher:

npm start

subtle-icons/
├── src/             # Source files
│   ├── acf/         # ACF Field react component
│   ├── blocks/      # Individual block directories
│   ├── components/  # Shared React components
│   ├── editor/      # Editor-side entry point
│   ├── hooks/       # Shared hooks
│   ├── sass/        # Global styles
│   └── utils/       # Utility helpers
├── build/           # Compiled output
├── inc/             # PHP includes (enqueue, ACF, REST)
└── subtle-icons.php

GPL-2.0-or-later — see GNU GPL v2.0.