Descripción
Subtle Icons is a bloat-free, lightweight plugin that brings thousands of icons directly into the WordPress block editor and Advanced Custom Fields (ACF).
Find the right icon, every time.
Powered by the massive open-source Iconify ecosystem, search and insert icons from Lucide, Material, Heroicons, and dozens of other icon libraries without leaving the editor — or upload your own SVGs.
Four lightweight blocks that cover the essentials.
- Icon Button Block: Prompt visitors to take action with a native-feeling button block supporting leading and trailing icons.
- Icon + Text Block: Pair an icon with text for notices, callouts, and feature highlights.
- Icon Block: A standalone icon block with sizing, thickness, and color controls.
- Icon List Block: Build beautiful, responsive lists with custom leading icons.
ACF Integration: Bring icons to your structured content
Add a full-featured icon field to taxonomies, repeaters, options pages, and custom blocks — anywhere ACF lives.
Built for custom integrations
Take full control of the icon workflow. Use our lightweight filters and actions to tailor the experience for your clients and custom builds.
- Filter or restrict available icon collections
- Configure default block icons globally
- Robust developer documentation and more extensibility coming soon!
Development
The complete source code for this plugin, including all uncompiled JavaScript and CSS, is publicly available at:
https://github.com/skysarwer/subtle-icons
Build requirements: Node.js and npm.
To build from source:
- Clone the repository:
git clone https://github.com/skysarwer/subtle-icons - Install dependencies:
npm install - Compile assets for production:
npm run build - Or start a development watcher:
npm start
External Services
This plugin uses the Iconify API to power the Icon Picker. The API is never called on the public frontend; it only runs in the WordPress admin when actively used by a logged-in user with post-editing capabilities. No personally identifiable information (PII) is transmitted.
How Data is Sent
- Server-to-Server (Proxy): Search queries (keywords) and icon retrievals (set prefix and icon name) are routed through a REST endpoint on your WordPress server. Iconify only sees your server’s IP address for these requests.
- Direct from Browser: Icon preview thumbnails in the search grid are loaded directly from the editor’s browser (via the @iconify/react library). The editor’s IP address and standard browser headers are visible to Iconify for these image requests.
API Endpoints (all operated by the Iconify project):
- Primary: api.iconify.design
- Fallbacks: api.simplesvg.com, api.unisvg.com
Iconify Policies & Links:
Capturas
The Icon Picker interface natively integrated into the Icon Button block.
Bloques
Este plugin proporciona 5 bloques.
- Icon Choose and display an icon.
- Icon List An organized collection of items displayed in a specific order.
- Icon Button Prompt visitors to take action with a button-style link that can include an SVG icon.
- Icon + Text Pair an icon with a text label. Useful for notices, callouts and rich headings.
- Icon List Item An individual item within a list.
Instalación
- Upload the plugin files to the
/wp-content/plugins/subtle-iconsdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the 'Plugins' screen in WordPress.
- Open the Block Editor and search for "Icon" to start using the blocks.
FAQ
-
Does this require Advanced Custom Fields?
-
No! The custom blocks work perfectly out of the box. The ACF field is just a bonus for developers who want to integrate icons into custom meta boxes.
-
Are the icons loaded locally or remotely?
-
The Icon Picker connects to Iconify via a proxy API to search icons, but the SVG code is embedded directly into your content. No third-party frontend assets are loaded on your live site.
-
How are the SVGs sanitized against malicious code?
-
Every icon is cleaned up twice before it ever touches your database — once in the browser the moment an icon is chosen, and again on the server when the post is saved. Both passes use strict allowlists that permit only the elements a real icon needs. Anything that could execute code or load an external resource is removed automatically, regardless of where the SVG came from.
The icon search itself only works for logged-in users who can already edit posts, so the feature is not exposed to the public.
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
"Subtle Icons" es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
Traduce "Subtle Icons" a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
1.0.5
- Test up to WP 7.0, update readme and plugin assets
1.0.2
- Initial release of Subtle Icons.