Description
Open Icons for ACF (Lite) adds a custom field type to Advanced Custom Fields (ACF) that lets you select and display SVG icons from the Heroicons library. All 324 icons are bundled with the plugin — no external downloads required.
Features:
- 324 Heroicons – Beautiful, hand-crafted SVG icons by the makers of Tailwind CSS
- Color palette – Define up to 3 color tokens and apply them to icons
- Bundled locally – All icons are included in the plugin, no external requests needed
- Clean output – Simple
get_openicon()helper function for displaying icons - Sanitised SVGs – All icons are sanitised for security
How it works:
- Add an “Open Icons” field to your ACF field group
- Select an icon and color from the beautiful picker interface
- Display the icon in your theme using the
get_openicon()function
Display icons in your theme:
php
<?php
$icon = get_field('your_icon_field');
get_openicon($icon, ['size' => 24, 'class' => 'my-icon']);
?>
Want more icons?
Open Icons for ACF Premium unlocks:
- Lucide Icons – 1,500+ icons
- Tabler Icons – 5,200+ icons
- Icon migration tools when switching providers
- Priority support
Development
The src/ directory contains the uncompiled React/TypeScript source code for the admin UI components.
Source code is available on GitHub:
https://github.com/davidosull/open-icons-acf-lite.git
To build from source:
- Clone the repository
- Run
npm install - Run
npm run build
This will bundle the Heroicons SVGs into assets/icons/ and compile the TypeScript/React source into assets/build/.
Installation
- Upload the
open-icons-acffolder to the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Ensure you have Advanced Custom Fields installed and activated
- Create a new field with the “Open Icons” type
FAQ
-
Does this plugin require ACF?
-
Yes, Open Icons for ACF (Lite) requires Advanced Custom Fields (free or Pro) to be installed and activated.
-
Can I use this with ACF PRO?
-
Absolutely! Open Icons for ACF (Lite) works with both the free version of ACF and ACF PRO.
-
No. The plugin will automatically prevent you from activating both versions simultaneously to avoid conflicts.
-
How do I display an icon in my theme?
-
Use the
get_openicon()function:php $icon = get_field('icon'); get_openicon($icon, ['size' => 24, 'class' => 'my-icon']); -
Can I change the icon color dynamically?
-
Yes! Pass a
colorparameter:php get_openicon($icon, ['color' => '#ff0000']); -
What icons are included?
-
The Lite version includes the full Heroicons library (324 icons). For access to Lucide (1,500+ icons) and Tabler (5,200+ icons), consider upgrading to Premium.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Open Icons for ACF (Lite)” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Open Icons for ACF (Lite)” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release of Open Icons for ACF (Lite).
- Breaking: Renamed public helper function from
openicon_open_icon()toget_openicon(). Update any theme templates that reference the old function name.