Title: Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field Author: Evan Buckiewicz Published: May 29, 2026 Last modified: May 30, 2026 --- Search plugins ![](https://ps.w.org/subtle-icons/assets/banner-772x250.png?rev=3554181) ![](https://ps.w.org/subtle-icons/assets/icon.svg?rev=3552964) # Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field By [Evan Buckiewicz](https://profiles.wordpress.org/evanworks/) [Download](https://downloads.wordpress.org/plugin/subtle-icons.1.0.8.zip) * [Details](https://mri.wordpress.org/plugins/subtle-icons/#description) * [Reviews](https://mri.wordpress.org/plugins/subtle-icons/#reviews) * [Installation](https://mri.wordpress.org/plugins/subtle-icons/#installation) * [Development](https://mri.wordpress.org/plugins/subtle-icons/#developers) [Support](https://wordpress.org/support/plugin/subtle-icons/) ## Description [Subtle Icons](https://subtleblocks.com/icons) is a lightweight plugin that brings thousands of icons directly into the WordPress block editor and Advanced Custom Fields (ACF). Stop enqueuing heavy FontAwesome stylesheets. Subtle Icons generates clean, inline SVG code natively in the editor, keeping your frontend free of external scripts and font files. ### The Ultimate WordPress Icon Picker Powered by the massive [Iconify](https://icon-sets.iconify.design/) ecosystem, easily search and insert icons from dozens of popular open-source libraries without leaving the WordPress editor. Supported libraries include: * Lucide Icons * Material Design Icons * Heroicons * FontAwesome * Bootstrap Icons * Phosphor Icons * …and dozens more, or upload your own custom SVGs! ### Four Native Gutenberg Icon Blocks * **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 SVG icon block with sizing, thickness, and color controls. * **Icon List Block:** Build beautiful, responsive lists with custom leading icons. ### Advanced Custom Fields (ACF) Integration Bring icons to your structured content. Subtle Icons adds a fully integrated Icon Picker field to ACF. Add icons to taxonomies, repeaters, options pages, and custom blocks seamlessly. ### Built for Developers & 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 this [public GitHub repo](https://github.com/skysarwer/subtle-icons). Build requirements: Node.js and npm. To build from source: 1. Clone the repository: `git clone https://github.com/skysarwer/subtle-icons` 2. Install dependencies: `npm install` 3. Compile assets for production: `npm run build` 4. Or start a development watcher: `npm start` ### External Services This plugin uses the [Iconify](https://iconify.design/) 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](https://api.iconify.design) * **Fallbacks:** [api.simplesvg.com](https://api.simplesvg.com), [api.unisvg.com](https://api.unisvg.com) #### Iconify Policies & Links: * [API documentation](https://iconify.design/docs/api/) * [Privacy policy](https://iconify.design/privacy/) ## Screenshots * [[ * The Icon Picker interface natively integrated into the Icon Button block. ## Blocks This plugin provides 5 blocks. * 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. ## Installation 1. Upload the plugin files to the `/wp-content/plugins/subtle-icons` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress. 3. 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. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field” is open source software. The following people have contributed to this plugin. Contributors * [ Evan Buckiewicz ](https://profiles.wordpress.org/evanworks/) [Translate “Subtle Icons – SVG Icon Block Suite, Icon Picker & ACF Field” into your language.](https://translate.wordpress.org/projects/wp-plugins/subtle-icons) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/subtle-icons/), check out the [SVN repository](https://plugins.svn.wordpress.org/subtle-icons/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/subtle-icons/) by [RSS](https://plugins.trac.wordpress.org/log/subtle-icons/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.7 * Test up to WP 7.0, update readme and plugin assets #### 1.0.2 * Initial release of Subtle Icons. ## Meta * Version **1.0.8** * Last updated **6 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.5 or higher ** * Tested up to **7.0** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/subtle-icons/) * Tags * [acf](https://mri.wordpress.org/plugins/tags/acf/)[icon](https://mri.wordpress.org/plugins/tags/icon/) [icon picker](https://mri.wordpress.org/plugins/tags/icon-picker/)[icon-block](https://mri.wordpress.org/plugins/tags/icon-block/) [SVG](https://mri.wordpress.org/plugins/tags/svg/) * [Advanced View](https://mri.wordpress.org/plugins/subtle-icons/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/subtle-icons/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/subtle-icons/reviews/) ## Contributors * [ Evan Buckiewicz ](https://profiles.wordpress.org/evanworks/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/subtle-icons/)