Title: Open Icons for ACF (Lite)
Author: davidbuilds
Published: <strong>March 26, 2026</strong>
Last modified: May 6, 2026

---

Search plugins

![](https://ps.w.org/open-icons-acf/assets/banner-772x250.png?rev=3491639)

![](https://ps.w.org/open-icons-acf/assets/icon.svg?rev=3491639)

# Open Icons for ACF (Lite)

 By [davidbuilds](https://profiles.wordpress.org/davidbuilds/)

[Download](https://downloads.wordpress.org/plugin/open-icons-acf.1.0.3.zip)

 * [Details](https://test.wordpress.org/plugins/open-icons-acf/#description)
 * [Reviews](https://test.wordpress.org/plugins/open-icons-acf/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/open-icons-acf/#installation)
 * [Development](https://test.wordpress.org/plugins/open-icons-acf/#developers)

 [Support](https://wordpress.org/support/plugin/open-icons-acf/)

## 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:**

 1. Add an “Open Icons” field to your ACF field group
 2. Select an icon and color from the beautiful picker interface
 3. 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](https://acfopenicons.com) unlocks:

 * **Lucide Icons** – 1,500+ icons
 * **Tabler Icons** – 5,200+ icons
 * **Custom Icons** – Add your own set of 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:

 1. Clone the repository
 2. Run `npm install`
 3. Run `npm run build`

This will bundle the Heroicons SVGs into `assets/icons/` and compile the TypeScript/
React source into `assets/build/`.

## Installation

 1. Upload the `open-icons-acf` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Ensure you have Advanced Custom Fields installed and activated
 4. 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.

### Can I have both Lite and Premium versions active?

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 `color` parameter:

    ```
    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

 *   [ davidbuilds ](https://profiles.wordpress.org/davidbuilds/)

[Translate “Open Icons for ACF (Lite)” into your language.](https://translate.wordpress.org/projects/wp-plugins/open-icons-acf)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/open-icons-acf/), check
out the [SVN repository](https://plugins.svn.wordpress.org/open-icons-acf/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/open-icons-acf/)
by [RSS](https://plugins.trac.wordpress.org/log/open-icons-acf/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.3

 * Release packaging fix.

#### 1.0.2

 * Improved icon picker browsing with a search-first layout and a dedicated “Browse
   all icons” action.
 * Added a “Common Icons” section that learns from usage frequency and recency to
   surface frequently selected icons.
 * Upgraded picker rendering with virtualised grid loading for smoother performance
   when browsing large icon lists.
 * Improved keyboard and scroll behaviour across recent, common, and full icon lists.

#### 1.0.1

 * Compatibility update for Pro migration release.
 * Added explicit conflict detection support for renamed Pro plugin paths and constants.

#### 1.0.0

 * Initial release of Open Icons for ACF (Lite).
 * **Breaking:** Renamed public helper function from `openicon_open_icon()` to `
   get_openicon()`. Update any theme templates that reference the old function name.

## Meta

 *  Version **1.0.3**
 *  Last updated **2 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.8 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/open-icons-acf/)
 * Tags
 * [acf](https://test.wordpress.org/plugins/tags/acf/)[custom fields](https://test.wordpress.org/plugins/tags/custom-fields/)
   [icons](https://test.wordpress.org/plugins/tags/icons/)[SVG](https://test.wordpress.org/plugins/tags/svg/)
 *  [Advanced View](https://test.wordpress.org/plugins/open-icons-acf/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/open-icons-acf/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/open-icons-acf/reviews/)

## Contributors

 *   [ davidbuilds ](https://profiles.wordpress.org/davidbuilds/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/open-icons-acf/)